生活物联网平台

首页> 开发者中心>生活物联网平台>应用开发指南>API说明>设备属性管理>获取预期属性

说明

调用该接口，可获取设备的预期属性值。

URL

/v1/iot/device/get_desired_property

请求方式

GET

URL参数

字段 类型 必选 说明
公共参数 是
product_key string 必须 产品唯一标识
device_name string 必须 设备唯一标识
items string 否 要查询的属性信息，是用逗号(英文逗号)隔开的属性的标识符（identifier）。
例如：items=“key1,key2”,如果传的值为空字符串(itmes=””)，则表示获取所有属性。

请求示例

curl ‘http:///v1/iot/device/get_desired_property?<公共参数>&product_key=xxxx&device_name=xxxx’

响应数据

字段 类型 说明
code int 响应状态码
msg string 响应状态描述
reqid string 请求唯一标识
data data 获取成功时返回的数据

data

字段 类型 说明
desired list 预期属性列表
report list 设备上报属性列表

响应示例

  1. {
  2.     "code": 0,
  3.     "msg": "Success",
  4.     "reqid": "xxxx-bn2ic95rurq6lg38ledg",    
  5.     "data":{
  6.             "desired":[                            #需要返回的设备期望属性的列表
  7.               {
  8.                   "identifier":"prop1"             #属性的唯一标识符
  9.                   "value":11,                      #设置的属性期望值，数据类型和物模型保持一致
  10.                   "timestamp":"1951234320000",     #设置属性期望值的最新时间戳，精确到毫秒，字符串类型
  11.               }
  12.             ],
  13.             "report":[                             #需要返回的设备上报属性的列表
  14.               {
  15.                   "identifier":"prop1"             #属性的唯一标识符
  16.                   "value":11,                      #上报的属性值，数据类型和物模型保持一致
  17.                   "timestamp":"1951234320000",     #上报属性的最新时间戳，精确到毫秒，字符串类型
  18.               }
  19.           ] 
  20.     } 
  21. }
即刻开始使用

只需完成注册与实名认证，即可体验我们的贴心服务

请您联系我们

邮箱

g-zyun@360.cn

电话

4000052360

小安提醒您

试用小安，请确保该账户已通过智汇云实名认证 前往认证中心>>

1对1免费 咨询智汇云专属顾问

为您量身定制产品解决方案

您的姓名 ：
手机号 ：
公司名称（选填) ：
相关产品 ：
留言内容 ：
提交
建议反馈
* 你对【智汇云】满意吗？
* 你对【智汇云】有哪些话要说？
+ 上传文件 支持格式 .png .jpg .jpeg .svg，不超过5MB。
取消 提交