Implement GET /devices/:topic in JS Client Library

[davidraker]

Get routes matching a topic for devices for all connected platforms.

Note: Platform Device endpoints accept query parameters to refine their output, as described in the introduction to the Devices section.

Note: See the introduction to the Platform Devices section for information on the use of topics.

Providing a partial topic returns all devices which share the given segements of the provided topic. Using a partial topic: /:campus/:building will produce the same dictionary as the response of GET /devices/ but with only the topics beginning with the segments :campus and :building.

Providing a full topic will usually produce a single result, except where more than one connected platform has the same topic, in which case the result will be the list of routes to that topic on each containing platform.

In the case where a device with the same topic appears on multiple platforms, the value for that topic in the result will be a list of routes where each element is the route to the device topic on on of the platforms where it appears.

Request:

• Authorization: BEARER <jwt_token>

Response:

• With valid BEARER token on success: 200 OK
  • Content Type: application/json
  • Body:

    {
        "<topic>": "/platform/:platform/devices/:topic",
        "<topic>": [
                    "/platform/:platform/devices/:topic",
                    "/platform/:platform/devices/:topic",
                   ]
        ...
    }
    

• With valid BEARER token on failure: 400 Bad Request
  • Content Type: application/json
  • Body:

    {
        "error": "<Error Message>"
    }
    

• With invalid BEARER token: 401 Unauthorized