With the Things endpoint in Bosch IoT Edge Services' REST service via set of GET HTTP requests you manage every Thing.

The Things is an endpoint, that gives you the possibility to retrieve the available information about a thing with given thingId. On the Bosch IoT Edge Services there is a thing representing the runtime itself – ID <gateway-id>:edge:services:runtime. Every device connected to the Edge Services has also a representation as a thing. You can request the whole thing, a subset of the thing, its policyId, attributes, features, properties or a single property.

• GET /things/?ids=

  You obtain multiple things with specified IDs, i.e. – GET /things?ids=namespace:id1,namespace:id2

• GET /things/{thingId}/attributes

  You obtain all attributes of the thing identified by the thingId path parameter.

• GET /things/{thingId}/attributes/{attributePath}

  You receive a specific attribute of the thing identified by the thingId path parameter.

• GET /things/{thingId}/definition

  You receive the definition of the thing identified by the thingId path parameter.

• GET /things/{thingId}/policyId

  You receive the policy ID of the thing identified by the thingId path parameter.

The Swagger provides the following interface for using the Things endpoint: