遠程升級OTA
產品簡介
產品定價
使用者指南
設備開發
最佳實踐
常見問題
更新日誌
根據設備唯一標識查詢設備ID
請求方式：GETURL：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"
}
}