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

标签信息上报

上行

  • 请求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号。上行消息ID需您自定义。需定义为String类型的数字,且设备维度唯一。
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号。上行消息ID需您自定义。需定义为String类型的数字,且设备维度唯一。
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 设备不存在。