Broker (API)

11KB

Broker.yaml

List MQTT topics under a prefix

get

Returns a paginated tree of MQTT topics starting from a given prefix with optional pagination.

Query parameters

prefixstringRequired

The root prefix to start listing from

Example: test/topic

depthintegerOptional

Depth to traverse in the topic tree

Default: 1

limitinteger · min: 1 · max: 100Optional

Maximum number of results to return

Default: 100

offsetintegerOptional

Offset to start listing from

Default: 0

last_nodestringOptional

Efficient jump to next offset by providing last queried topic node

Example: test/topic/100

Responses

200

List of matched MQTT topics

application/json

400

Problem with query parameters

application/vnd.api+json

404

No matched MQTT topics

application/vnd.api+json

413

Query would result too many nodes, user needs to narrow down the search

application/vnd.api+json

429

Request had to stay in queue for more than 10s or queue already has 10 waiting requests, default rate is 10 per second, max 3 concurrent running request

application/vnd.api+json

500

Query crashed for any reason

application/vnd.api+json

504

Query processing took more than 10s

application/vnd.api+json

get

HTTPcURLJavaScriptPython

GET /api/v2/mqtt/topics?prefix=test%2Ftopic HTTP/1.1
Host: 
Accept: */*

{
  "jsonapi": {
    "version": "text"
  },
  "meta": {
    "prefix": "test/topic",
    "depth": 1,
    "limit": 10,
    "offset": 0,
    "total": 312074,
    "last_node": "test/topic/100"
  },
  "data": [
    {
      "id": "test/100002",
      "type": "topic-nodes",
      "attributes": {
        "name": "100002",
        "isLeaf": true,
        "childCount": 1
      }
    }
  ],
  "included": []
}