Messages API v1 - deprecated

Messages can be used to transport arbitrary data between IoT devices and applications. To invoke e.g. an operation on a device, a message can be sent to the thing or one of its features. You can send messages to or from a thing and by specifying a subject which defines the meaning of the message. Messages contain custom payload with a custom content-type.

Messages resource

There is no root resource for Messages as they are always related to a Thing.

The following operations are available over the HTTP API: cr-rest-api-messages.png

Note on Message Subjects

note Note on messageSubject:
Due to the fact that a Message Subject might need to be set in the path, we have restricted the set of allowed characters to those for Uniform Resource Identifiers (URI) see http://www.ietf.org/rfc/rfc2396.txt.

Note on Claiming

Bosch IoT Things provides a HTTP API for claiming to enable end-users to claim Things and proof ownership thereof.

By posting to a Thing’s claim resource, our service sends a claim message to the Thing. The request may contain an arbitrary body and content-type to allow Thing-specific implementation of the actual claiming. The claiming will not be terminated or evaluated at our service, therefore the decision whether to grant access (by setting permissions) is completely up to the client(s) which handle the claim message.

To prevent brute-force attacks, the Bosch IoT Things service implements rate limiting and defines a default timeout for claiming requests at the claim HTTP API.

Find details at Basic concepts > … > Claiming.

Imprint Legal info Privacy statement