1. 接口描述
接口请求域名:
wss://iot.cloud.tencent.com/iotstudio_v2_weapp_1
本接口(DeviceRegistrationMonitor)用于向 WS 服务端进行订阅,订阅成功后可以通过ws.onmessage
的监听获取到 WS 服务端实时推送设备上下线状态及属性数据。2. 输入参数
名称 | 类型 | 必选 | 描述 |
action | String | 是 | 公共参数,本接口取值:ActivePush。 |
reqId | String | 是 | 公共参数,标示请求序列,唯一请求 ID,可自行生成。 |
params | 是 | 注册设备的时候传入的参数。 |
3. 输出参数
名称 | 类型 | 描述 |
reqId | String | 公共参数,标示请求序列,与入参相同。 |
error | String | 状态码,为空表示正确。 |
error_message | String | 错误详细说明,为空表示正确。 |
data | 监听之后的服务器回包。 |
4. 示例
示例1
输入示例 (发送前需将数据转换为 json 字符串)
ws.send(JSON.stringify({"action": "ActivePush","reqId": "req0001","params":{"DeviceIds": ["产品ID/DeviceName","产品ID/DeviceName"],"AccessToken": "f6******************3aad"}}));
输出示例:成功
{"error":"","error_message":"","data":{"deviceIds":["产品ID/DeviceName","产品ID/DeviceName"]},"reqId":"req0001"}
输出示例:失败
{"error":"","error_message":"","data":{"deviceIds":[]},"reqId":"req0001"}