she_bei_xin_xi_huo_qu.md

设备信息获取

AIOT开放API可供第三方应用查询设备基本信息，如

• name: 设备名称
• model: 设备类型
• firmwareVersion: 设备固件版本
• chipVersion: 设备芯片版本
• state: 设备在线离线状态

详细API定义以AIOT开放平台网站“API访问”页面的信息为准。

API	/open/device/query
描述	查询设备信息
header	{"Appid":"xxx","Appkey":"xxx","Openid":"xxx","Access-Token":"xxx"}
payload	{"openId":"xxx","did":"xxx"}
response	{"code":0(errorcode), "result":{"did":"xxx", "model":"xxx", "name":"xxx", "firmwareVersion": "xxx", "state":"xxx", "chipVersion":"xxx"}}}

API	/open/device/query/option
描述	查询设备特定信息
header	{"Appid":"xxx","Appkey":"xxx","Openid":"xxx","Access-Token":"xxx"}
payload	{"openId":"xxx","did":"xxx","option":["option1","option2",...]}
response	{"code":0(errorcode), "result":{"did":"xxx", "option1":"xxx", "option2":"xxx", ...}}

API	/open/device/query/children
描述	查询网关下子设备信息
header	{"Appid":"xxx","Appkey":"xxx","Openid":"xxx","Access-Token":"xxx"}
payload	{"openId":"xxx","did":"xxx"}
response	{"code":0(errorcode), "result":[{"did":"xxx", "model":"xxx", "name":"xxx", "firmwareVersion": "xxx", "state":"xxx", "chipVersion":"xxx"}]}}

API	/open/device/query/children/option
描述	查询网关下子设备特定信息
header	{"Appid":"xxx","Appkey":"xxx","Openid":"xxx","Access-Token":"xxx"}
payload	{"openId":"xxx","did":"xxx","option":["option1","option2",...]}
response	{"code":0(errorcode), "result":[{"did":"xxx", "option1":"xxx", "option2":"xxx", ...}]}}

API	/open/device/query/user
描述	查询用户所有设备的信息
header	{"Appid":"xxx","Appkey":"xxx","Openid":"xxx","Access-Token":"xxx"}
payload	{"openId":"xxx"}
response	{"code":0(errorcode), "result":[{"did":"xxx", "model":"xxx", "name":"xxx", "firmwareVersion": "xxx", "state":"xxx", "chipVersion":"xxx", "longitude":"xxx", "latitude":"xxx"}{"did":"xxx", "model":"xxx", "name":"xxx", "firmwareVersion": "xxx", "state":"xxx", "chipVersion":"xxx"}]}}

• did: 设备id
• openId: 用户id
• Appid: 第三方应用appId
• Appkey: 第三方应用appKey
• Access-Token: 用户token
• state: 设备在线/离线状态，0-离线,1-在线
• errorcode: 错误码，详见附件