设备服务
约 631 字大约 2 分钟
2025-03-19
简介
设备服务提供设备服务相关功能实现
app绑定上报(版本>=1.4.0)

- 中绑定的情况下需要设备上报云端下发的token,用户才能绑定成功 Topic:
- 下行请求 Topic:
$thing/down/service/{ProductID}/{DeviceName}
- 上行响应 Topic:
$thing/up/service/{ProductID}/{DeviceName}
- 下行请求 Topic:
- 请求
- 设备端请求报文示例:
{
"method": "appBindToken",
"msgToken": "1234567",
"params": {
"token": "123"
}
}
- 请求参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
method | String | 是 | appBindToken 表示设备上报app绑定的token |
msgToken | String | 是 | 用于上下行消息配对标识 |
timestamp | Integer | 否 | 属性上报的时间,格式为 UNIX 系统时间戳,不填写该字段表示默认为当前系统时间。单位为毫秒 |
params.token | string | 是 | 云端下发的token |
- 响应
- 云端返回设备端报文示例:
{
"method":"appBindToken",
"msgToken":"123",
"code":200,
"msg":"some message where error"
}
- 响应参数说明:
参数 | 类型 | 说明 |
---|---|---|
method | String | reportReply 表示云端接收设备上报后的响应报文 |
msgToken | String | 用于上下行消息配对标识 |
code | Integer | 200表示云端成功收到设备上报的属性 |
msg | String | 当 code 非200的时候,提示错误信息 |
设备绑定及解绑通知(版本>=1.4.0)
设备被用户绑定或解绑及设备上报基础信息中绑定的用户不同,设备将收到新的绑定信息:
- 中绑定的情况下需要设备上报云端下发的token,用户才能绑定成功 Topic:
- 下行请求 Topic:
$thing/down/service/{ProductID}/{DeviceName}
- 上行响应 Topic:
$thing/up/service/{ProductID}/{DeviceName}
- 下行请求 Topic:
- 请求
- 云端端请求报文示例:
{
"method": "bingChange",
"msgToken": "1234567",
"params": {
"projectID": "123"
}
}
- 请求参数说明:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
method | String | 是 | appBindToken 表示设备上报app绑定的token |
msgToken | String | 是 | 用于上下行消息配对标识 |
timestamp | Integer | 否 | 属性上报的时间,格式为 UNIX 系统时间戳,不填写该字段表示默认为当前系统时间。单位为毫秒 |
params.projectID | string | 是 | 绑定的家庭或项目的id |
- 响应
- 设备响应报文示例:
{
"method":"bingChange",
"msgToken":"123",
"code":200,
"msg":"some message where error"
}
- 响应参数说明:
参数 | 类型 | 说明 |
---|---|---|
method | String | bingChange 表示云端接收设备上报后的响应报文 |
msgToken | String | 用于上下行消息配对标识 |
code | Integer | 200表示云端成功收到设备上报的属性 |
msg | String | 当 code 非200的时候,提示错误信息 |