批量查询设备在线状态
更新时间 2025-08-04 16:57:32
最近更新时间: 2025-08-04 16:57:32
本文为您介绍分布式消息服务MQTT的API-设备客户端-批量查询设备在线状态。
POST https://[endpoint].ctapi.ctyun.cn/v3/api/batchClientOnLine
Content-Type：application/json
请求体json参数说明：
| 参数名 | 参数类型 | 是否必填 | 参数描述 |
|---|---|---|---|
| prodInstId | Text | 是 | 实例Id |
| clientIds | Text | 是 | clientIds 设备ID 多个以逗号隔开 必填,一次最多查10个 |
返回参数说明：
| 参数名 | 参数类型 | 参数描述 |
|---|---|---|
| returnObj | Object | 返回对象 |
| returnObj.clientId | String | 设备ID |
| returnObj.online | Boolean | 是否在线 |
| message | String | 描述状态 |
| statusCode | Integer | 800-成功 其他失败 |
返回示例：成功
| {"returnObj": [{"clientId": "aaa","online": true},{"clientId": "aaax","online": true}]} |
|---|
返回示例：失败
| {"returnObj": null,"message": "error","statusCode": "900"} |
|---|
