目录 [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数据。