远程升级OTA
产品简介
产品定价
用户指南
设备开发
最佳实践
常见问题
更新日志
根据设备唯一标识查询设备ID
请求方式：GET
URL: http://ota.heclouds.com/ota/devInfo
设备ID是平台为每个设备分配的、具有唯一性的ID号，若您的设备暂未获取到设备ID，并且在首次接入平台时需要进行升级，可通过该接口使用设备唯一标识获取到设备ID。
http头部
| 参数名称 | 格式 | 是否必须 | 说明 |
|---|---|---|---|
| Content-Type | string | 是 | 必须为application/json |
| Authorization | string | 是 | 安全鉴权信息 |
http 请求body
| 参数名称 | 格式 | 是否必须 | 说明 |
|---|---|---|---|
| pid | long | 是 | 产品id |
| authInfo | string | 是 | 设备唯一标识，详情请查看下文说明 |
返回参数
| 参数名称 | 格式 | 说明 |
|---|---|---|
| errno | int | 调用错误码，为0表示调用成功 |
| error | string | 错误描述，为"succ"表示调用成功 |
| data | json | 接口调用成功之后返回的设备相关信息，见data描述表 |
data描述表
| 参数名称 | 格式 | 说明 |
|---|---|---|
| dev_id | string | 设备ID |
说明
请求参数authInfo根据产品协议不同，对应含义不同，详情如下：
如果产品是NB协议，那么设备唯一标识就是在平台创建设备时的“IMEI”字段；
如果产品是MQTTS（新版MQTT）协议，那么设备唯一标识就是在平台创建设备时的“设备名称”字段；
如果产品是MQTT/EDP/TCP透传协议，那么设备唯一标识就是在平台创建设备时的“鉴权信息”字段；
如果产品是HTTP协议，那么设备唯一标识就在平台创建设备时的“设备编号”字段；
如果产品是Modbus协议，那么设备唯一标识是在平台创建设备时的“DTU序列号”和“DTU密码”字段组成的json字符串；
如果产品是JT/T808协议，那么设备唯一标识是在平台创建设备时的“终端型号”和“终端ID”字段组成的json字符串。
请求示例
{
"pid":123,
"authInfo":"869975036903162"//NB设备的唯一标识为IMEI号，其他协议请参考上文“说明”
}
返回示例
{
"errno": 0,
"error":"succ",
"data":
{
"dev_id":"233444"
}
}