The Things-Search is an endpoint in the Bosch IoT Edge Services' REST service via full support of GET requests to list all things which you are allowed to see.

The Things-Search is an endpoint, that gives you the possibility to retrieve all currently available in the Edge Services' things. This endpoint supports filtering, based on predicates matching properties or attributes:

• GET /search/things

  With this endpoint you can search for things.

• GET /search/things/count

  With this endpoint you can count things.

You can also:

• re-order the result,
• adjust the size of the returned things.

Sorting Things

The search request gives you the opportunity to get the result sorted by some parameter. This can be made with the sort option. You can select the sort order – ascending or descending.

Examples of sort options:

• sort(+thingId)
• sort(-attributes/manufacturer)
• sort(+thingId,-attributes/manufacturer)

If the count of the returned things is bigger than the size (the default is 25) a cursor is created and returned in the result. Use this cursor (without quotes) for getting the next section of the result.

When using the cursor option, you should not change the other options or you will end up with error response from the request.

Then you can take:

• all Things;
• only their IDs;
• only the Features;
• or see what are the properties of a Feature, etc.

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