Topic Explorer (API)

6KB

Topic Explorer.yaml

Open

Get immediate children of a prefix

get

Returns the child nodes for a given prefix.

Authorizations

ApiKeyHeader

Query parameters

prefixstringOptional

Path prefix (URL-encoded). Needs to be built by joining previous levels with '/'. If omitted, root level is assumed.

Responses

200

List of child nodes wrapped in JSON:API envelope.

application/json

500

Internal error retrieving levels.

application/json

503

Service Unavailable (Infrastructure error)

text/plain

get

/v2/mqtt/topics/levels

HTTPcURLJavaScriptPython

GET /api/v2/mqtt/topics/levels HTTP/1.1
Host: localhost
Accept: */*

{
  "jsonapi": {
    "version": "1.1"
  },
  "data": {
    "children": [
      {
        "name": "Germany",
        "has_more": true
      },
      {
        "name": "France",
        "has_more": true
      }
    ]
  },
  "meta": {}
}

Search topics by prefix

get

Returns all topics matching a given prefix.

Authorizations

ApiKeyHeader

Query parameters

prefixstringRequired

Path prefix to search for (URL-encoded).

Responses

200

Search results wrapped in JSON:API envelope.

application/json

400

Missing prefix parameter.

application/json

500

Internal error during search.

application/json

503

Service Unavailable (Infrastructure error)

text/plain

get

/v2/mqtt/topics/search

HTTPcURLJavaScriptPython

GET /api/v2/mqtt/topics/search?prefix=text HTTP/1.1
Host: localhost
Accept: */*

{
  "jsonapi": {
    "version": "1.1"
  },
  "data": [
    "Earth/Germany/Berlin/",
    "Earth/Germany/Hamburg"
  ],
  "meta": {}
}