Streaming WebSocket API: /signalk/v1/stream
Initiates a WebSocket connection that will start streaming the server's updates as Signal K delta messages. You can specify the contents of the stream by using a specific URL:
- ws://hostname/signalk/v1/stream?subscribe=self
- ws://hostname/signalk/v1/stream?subscribe=all
- ws://hostname/signalk/v1/stream?subscribe=none
With no query parameter the default is self
, which will stream the data related to the self
object. all
will stream all the updates the server sees and none
will stream only the heartbeat, until the client issues subscribe messages in the WebSocket stream.
If a server does not support some streaming options listed in here it must respond with http status code 501 Not Implemented
.
See Subscription Protocol for more details.
Connection Hello
Upon connection a 'hello' message is sent as follows:
{
"version": "1.1.2",
"timestamp": "2015-04-13T01:13:50.524Z",
"self": "123456789"
}