目錄 [TOC] ## 一、創恒云轉發設備數據至用戶指定HTTP POST API 此功能用于數據由創恒云服務器POST到用戶指定服務器HTTP API 需要在創恒云平臺設備列表設置每個設備的上報地址; 點擊設備列表，選擇設備，勾選自定義下發地址，填寫地址。  **POST 調用參數及說明** | 字段 |說明 | 類型 |備注 | | --- | --- | --- | --- | | time | 數據上傳時間 | int | | | deviceId | 設備唯一id | string | | | data | 點數據 | array | | | isOnline| 在線狀態 | bool | true 在線 false 離線 | | name | 點名稱 | string | | | value | 點數據 | int | | **上傳數據格式示例** ``` { "time": 1599643187054, "deviceId": "5f58799aa07e782a9948c003", "data": [ { "name": "數據點2", "value": 1 }, { "name": "數據點1", "value": 1 }， ...... ], "isOnline": true } ``` ## 二、創恒云獲取設備數據信息 >[success]請求地址 `https://cloud.truhigh.com/api/IoTDevice/get-data?id=設備ID` 請求類型 `GET` 請求參數及說明: | 字段 |說明 | 類型 |備注 | | --- | --- | --- | --- | | id| 設備唯一ID | string | 設備的_id字段 | 返回內容描述 | 字段 |說明 | 類型 |備注 | | --- | --- | --- | --- | | success| 結果| bool | true 獲取成功、false 獲取失敗 | | message| 描述| string | 失敗時返回 | | isOnline | 信息| bool |設備在線離線信息| | points| 數據| Object| 設備數據信息| **成功返回示例** ``` { "success":?true, "isOnline":true, //設備在線離線信息 "points":?{ "q":?{ //數據點名 "value":?0, //數據點值 "time":?1606718985087 //獲取數據點值的時間 ??} .... ??} } ``` ## 三、創恒云接收HTTP POST請求并下發到設備 請求地址 ```https://cloud.truhigh.com/api/IoTDevice/sendDatas``` POST請求參數及說明 | 字段 |說明 | 類型 |備注 | | --- | --- | --- | --- | | deviceId | 設備唯一id | string | | | sendDeviceData| 點數據| 數組 | 目前僅支持單點下發，后續會上線多點下發 | 返回內容 | 字段 |說明 | 類型 |備注 | | --- | --- | --- | --- | | message | 描述| string | | | success| 結果| int | 1 成功、0 失敗 | 示例： 請求內容： ``` { "deviceId": "5f58799aa07e782a9948c003", "sendDeviceData": [ { "name": "數據點3", "value": "0" } ] } ``` 返回內容： ``` { "message": "下發成功", "success": 1 } ``` ## 四、創恒云獲取網關GPS信息 >[success]請求地址 `https://cloud.truhigh.com/api/IoTDevice/v1/get-device-gps?_id=網關ID` 請求類型 `GET` 請求參數及說明: | 字段 |說明 | 類型 |備注 | | --- | --- | --- | --- | | _id| 網關唯一id | string | 網關的_id字段 | 返回內容描述 | 字段 |說明 | 類型 |備注 | | --- | --- | --- | --- | | code| 結果| int | 1 獲取成功、0 獲取失敗 | | msg| 描述| string | 返回信息，見下方注釋1 | | data| 數據| Object| GPS數據信息| >[warning]**注釋** 1 若msg字段為數據庫查詢失敗not found"，則網關設備可能未上傳GPS數據。