设备调试与消息下发

设备调试包含两部分：查询设备上下行消息流水，以及向设备 Topic 下发消息（模拟平台行为，验证设备订阅与解析逻辑）。

查询设备消息流水分页

GET	/admin-api/iot/device-msg-log/page

请求数据类型 ：application/json;charset=UTF-8

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
pageNo	页码，从 1 开始,示例值(1)	query	false	int32
pageSize	每页条数，最大值为 1000,示例值(10)	query	false	int32
productKey	产品productKey	query	true	string
deviceName	设备唯一标识	query	true	string
topicLog	消息Topic，如 /sys/...	query	false	string
traceId	追踪id	query	false	string
msgFrom	消息来源	query	false	string
payload	消息内容	query	false	string
ts	时间范围，格式：ts[0]=2026-10-01 00:00:00&ts[1]=2026-10-25 23:59:59	query	false	array[datetime]
Authorization	认证 Token,示例值(Bearer be080642804d4af285ccccaefcb66eda) 获取access_token请参考获取访问令牌	header	true	string

响应状态

状态码	说明
200	OK

响应参数

参数名称	参数说明	数据类型
status	状态码，值为0正常，其他值为异常	int
code	结果同status一样，冗余字段	int
data	分页数据	object
---total	返回结果条数	int
---list	返回数据列表	array
------ts	消息时间戳，13位	long
------traceId	追踪id	string
------msgFrom	消息来源	string
------topicLog	消息Topic	string
------payload	消息内容	string
------productKey	产品productKey	string
------deviceName	设备唯一标识	string
msg	状态消息	string

响应示例

{
  "status": 0,
  "code": 0,
  "data": {
    "list": [
      {
        "ts": 1733653343516,
        "traceId": "a1b2c3d4",
        "msgFrom": "device",
        "topicLog": "/sys/kza2ib/cc50e34bf075/thing/event/property/post",
        "payload": "{\"id\":\"1\",\"params\":{\"temperature\":23.6}}",
        "productKey": "kza2ib",
        "deviceName": "cc50e34bf075"
      }
    ],
    "total": 1
  },
  "msg": ""
}

下发消息到设备

POST	/admin-api/iot/device-info/publish

请求数据类型 ：application/json;charset=UTF-8

接口描述

向指定设备的任意 Topic 发布一条消息（走 EMQX REST 真实下发），用于联调验证设备的订阅与解析逻辑。调用方需具备 iot:device-info:publish 权限。

请求参数

参数名称	参数说明	请求类型	是否必须	数据类型
deviceId	设备id	json	true	long
topic	完整下行Topic，如 /sys/{pk}/{dn}/thing/service/property/set	json	true	string
qos	消息QoS，可选值 0 / 1	json	false	int
msgContent	消息内容，原始字符串（JSON 报文需自行转义）	json	true	string
Authorization	认证 Token,示例值(Bearer be080642804d4af285ccccaefcb66eda) 获取access_token请参考获取访问令牌	header	true	string

请求示例

{
  "deviceId": 1414749481172992,
  "topic": "/sys/kza2ib/cc50e34bf075/thing/service/property/set",
  "qos": 0,
  "msgContent": "{\"id\":\"debug-1\",\"timestamp\":1700000000000,\"params\":{\"Power\":\"on\"},\"method\":\"thing.service.property.set\"}"
}

响应状态

状态码	说明
200	OK

响应参数

参数名称	参数说明	数据类型
status	状态码，值为0正常，其他值为异常	int
code	结果同status一样，冗余字段	int
data	下发成功返回true	boolean
msg	状态消息	string

注意

设备必须已订阅目标 Topic 才能收到消息（平台不会自动订阅）。同名的遗留接口 POST /admin-api/iot/device-info/device/publish 走早期 Redis 流通道，在当前 EMQX 架构下不会真正下发，请勿使用。