希沃物联平台文档

查询topic列表

此接口用于查询产品级的topic列表。

1 接口路径

GET /api/v1/topic

2 请求参数

query参数：

名称 类型 是否必需 描述
productKey String 是 产品唯一标识

3 返回参数

统一返回参数说明参考：公共参数，正常返回的业务参数（data）为对象数组，以下是数组元素描述：

名称 类型 描述
id BigInteger 消息队列ID
productKey String 产品唯一标识
description String 队列描述
permissionType String 权限类型
isDefault Boolean 是否默认队列
url String 队列URL

4 返回状态码

公共状态码说明参考：公共参数，以下是业务关联的状态码说明：

5 示例

请求示例

/api/v1/topic/?productKey=1_783dcb3cf4d

返回示例

{
    "code": "000000",
    "data": [
        {
            "description": "默认topic",
            "id": "297159870526930946",
            "isDefault": true,
            "permissionType": "PUBLISH_SUBSCRIPTION",
            "productKey": "1_783dcb3cf4d",
            "url": "/sys/${productKey}/${deviceId}/rpc/request/${messageId}"
        },
        {
            "description": "1类通配符，勿删",
            "id": "297159870707286016",
            "isDefault": false,
            "permissionType": "SUBSCRIPTION",
            "productKey": "1_783dcb3cf4d",
            "url": "/user/${productKey}/${deviceId}/custom/1/+"
        },
        {
            "description": "",
            "id": "297159870719868928",
            "isDefault": false,
            "permissionType": "PUBLISH",
            "productKey": "1_783dcb3cf4d",
            "url": "/user/${productKey}/${deviceId}/custom/1/1"
        }
    ],
    "message": "success"
}