1.3.1 Creating WebSockets

Creating a websocket id a two-step procedure: First a websocket ID must be obtained. This is done using the /api/v1/makewebsocket API call. This call prepares a websocket which can be connected to. It returns an ID for the newly prepared websocket. The client must remember this ID during the session, it is required for all subsequent operations on this websocket.

The second step is to connect to this websocket. The URL for these websockets is /msgs, all connections share this. To identify which websocket to open, a query parameter defining the websocket ID must added to the HTTP URI when opening the websocket:

/msgs&satnmsWebsocketId=XXXXX

XXXXX has to be replaced by the 5-character websocket ID obtained with the /api/v1/makewebsocket API call.

The now connected websocket does not receive any data.