WebSocket binding

The Things Protocol message can be sent as is as WebSocket message. The Things Protocol JSON must be sent as UTF-8 encoded String payload.

How it works:

  • It supports command messages for create, retrieve, modify and delete.
  • It also supports response and events for these operations.
  • A reactive-streams protocol for search is supported.
  • Messages not matching the protocol specification are ignored.

Things WebSocket endpoint

The WebSocket endpoint pattern depends on which API version you use

wss://<host>/ws/2

wss://<host>/ws/1 - deprecated

tip Find the list of all endpoints at our FAQ section How to find the endpoints for my subscription?

Authenticate

A user or technical client who connects to the WebSocket endpoint can be authenticated by using a JSON Web Token (JWT).

See Authenticate as a user and Authenticate as a client for more details.

WebSocket documentation at Ditto

tip As the Bosch IoT Things service is built upon the Eclipse Ditto project, the specification documented there applies accordingly.
https://www.eclipse.org/ditto/httpapi-protocol-bindings-websocket.html

Imprint Legal info Privacy statement