设备上报部分信息,如厂商、设备型号等,可以保存为设备标签。

标签信息上报

上行

  • 请求Topic:/sys/{productKey}/{deviceName}/thing/deviceinfo/update
  • 响应Topic:/sys/{productKey}/{deviceName}/thing/deviceinfo/update_reply

Alink请求数据格式

{
  "id": "123",
  "version": "1.0",
  "params": [
    {
      "attrKey": "Temperature",
      "attrValue": "36.8"
    }
  ],
  "method": "thing.deviceinfo.update"
}

Alink响应数据格式

{
  "id": "123",
  "code": 200,
  "data": {}
}

参数说明:

参数 类型 说明
id String 消息ID号。String类型的数字,取值范围0~4294967295,且每个消息ID在当前设备中具有唯一性。
version String 协议版本号,目前协议版本号唯一取值为1.0
params Object

请求参数,包含标签的键attrKey和值attrValue

params元素个数不超过200个。

method String 请求方法,取值thing.deviceinfo.update
attrKey String

标签Key。

  • 长度不超过64字节。
  • 仅允许字符集为英文大小写字母、数字和下划线。
  • 首字符必须是字母或者下划线。
attrValue String 标签的值。可包含中文汉字、英文字母、数字、下划线(_)、连字符(-)和点号(.)。
code Integer 结果信息, 200表示成功。

错误码

错误码 消息 描述
460 request parameter error 请求参数错误。
6100 device not found 设备不存在。

删除标签信息

上行

  • 请求Topic:/sys/{productKey}/{deviceName}/thing/deviceinfo/delete
  • 响应Topic:/sys/{productKey}/{deviceName}/thing/deviceinfo/delete_reply

Alink请求数据格式

{
  "id": "123",
  "version": "1.0",
  "params": [
    {
      "attrKey": "Temperature"
    }
  ],
  "method": "thing.deviceinfo.delete"
}

Alink响应数据格式

{
  "id": "123",
  "code": 200,
  "data": {}
}

参数说明:

参数 类型 说明
id String 消息ID号。String类型的数字,取值范围0~4294967295,且每个消息ID在当前设备中具有唯一性。
version String 协议版本号,目前协议版本号唯一取值为1.0
params Object 请求参数,包含要删除的标签键attrKey参数。
method String 请求方法,取值thing.deviceinfo.delete
attrKey String 要删除标签的Key。
code Integer 结果信息, 200表示成功。

错误信息

错误码 消息 描述
460 request parameter error 请求参数错误。
6100 device not found 设备不存在。