文档中心 > API类目 > 智能设备

qimen.alibaba.retail.device.info.report (上报设备属性信息)

当设备开机上报其属性信息时,或其它情况下设备属性信息有变化时,向ISV上报设备属性信息。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
deviceCode String 必须 a123456 即TmallDeviceCode
deviceSn String 必须 asdfasdf 即TmallDeviceSn
androidVersion Number 必须 25 安卓版本
firmwareVersion String 必须 1.0.0.1-R-20181019.1000 固件版本
atmVersion String 必须 1.0.8 终控APP版本
longitude String 可选 11.22 经度
latitude String 可选 22.33 纬度
altitude String 可选 33.44 海拔
currentTemperature String 可选 22.5 当前温度
ipcVersion String 可选 1.3 工控机版本
deviceSdkVersion String 可选 2.4 设备SDK版本
attribute String 可选 {"light":"on"} 扩展字段(JSON字符串)

响应参数

名称 类型 示例值 描述
code String CE000 错误码
msg String 失败了 错误信息
succ Boolean true 是否成功

请求示例

{"altitude":"33.44","currentTemperature":"22.5","androidVersion":25,"latitude":"22.33","deviceCode":"a123456","attribute":"{\"light\":\"on\"}","firmwareVersion":"1.0.0.1-R-20181019.1000","deviceSdkVersion":"2.4","deviceSn":"asdfasdf","atmVersion":"1.0.8","ipcVersion":"1.3","longitude":"11.22"}

响应示例

{
    "code":"CE000",
    "msg":"失败了",
    "succ":true
}

验签示例

{"msg":"Illegal request","code":"sign-check-failure","succ":"不等于true"}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部