联犀开发者文档

设备服务

约 679 字大约 2 分钟

2025-03-19

简介

设备服务提供设备服务相关功能实现。

参数说明

  • {productID}：产品ID。
  • {deviceName}：设备ID。
  • 通用请求参数
参数类型必填说明
msgTokenString是用于上下行消息配对标识
sys.noAskbool否云端是否回复设备
sys.retMsgbool否是否返回错误信息,字段为msg
示例:
{
  "method": "reportInfo",
  "msgToken": "1234567",
  "sys": {
     "noAsk": false,
     "retMsg": true
  }
}

App绑定上报（版本 >= 1.4.0）

1. Topic说明

中绑定的情况下需要设备上报云端下发的token，用户才能绑定成功：

  • 下行请求 Topic： $thing/down/service/{ProductID}/{DeviceName}
  • 上行响应 Topic： $thing/up/service/{ProductID}/{DeviceName}

2. 请求

设备端请求报文示例：

{
  "method": "appBindToken",
  "msgToken": "1234567",
  "params": {
    "token": "123"
  }
}

请求参数说明：

参数类型必填说明
methodString是appBindToken 表示设备上报app绑定的token
msgTokenString是用于上下行消息配对标识
timestampInteger否属性上报的时间，格式为UNIX系统时间戳，不填写该字段表示默认为当前系统时间，单位为毫秒
params.tokenString是云端下发的token

3. 响应

云端返回设备端报文示例：

{
  "method": "appBindToken",
  "msgToken": "123",
  "code": 200,
  "msg": "some message where error"
}

响应参数说明：

参数类型说明
methodStringreportReply 表示云端接收设备上报后的响应报文
msgTokenString用于上下行消息配对标识
codeInteger200表示云端成功收到设备上报的属性
msgString当code非200的时候，提示错误信息

设备绑定及解绑通知（版本 >= 1.4.0）

设备被用户绑定或解绑及设备上报基础信息中绑定的用户不同，设备将收到新的绑定信息：

1. Topic说明

  • 下行请求 Topic： $thing/down/service/{ProductID}/{DeviceName}
  • 上行响应 Topic： $thing/up/service/{ProductID}/{DeviceName}

2. 请求

云端请求报文示例：

{
  "method": "bingChange",
  "msgToken": "1234567",
  "params": {
    "projectID": "123"
  }
}

请求参数说明：

参数类型必填说明
methodString是bingChange 表示设备绑定变更通知
msgTokenString是用于上下行消息配对标识
timestampInteger否属性上报的时间，格式为UNIX系统时间戳，不填写该字段表示默认为当前系统时间，单位为毫秒
params.projectIDString是绑定的家庭或项目的ID

3. 响应

设备响应报文示例：

{
  "method": "bingChange",
  "msgToken": "123",
  "code": 200,
  "msg": "some message where error"
}

响应参数说明：

参数类型说明
methodStringbingChange 表示云端接收设备上报后的响应报文
msgTokenString用于上下行消息配对标识
codeInteger200表示云端成功收到设备上报的属性
msgString当code非200的时候，提示错误信息

更新日志

2026/8/4 07:04
查看所有更新日志
  • 7e927-文档站全面重构：目录重排、首页重写、案例独立成站、应用市场下线于
  • bddea-docs: 更新文档结构、添加新内容并优化现有文档于
  • 706e5-doc于
  • 6fa0c-doc于
  • 51ff0-doc于
  • 1eefd-doc于