数据推送-扩展功能-有人云

### 概述
数据推送是用于开发者开发自己个性化业务系统时，让平台向用户指定的第三方URL地址通过Http或Https推送设备产生的数据(如设备变量数据,定位数据等)。

### 操作流程

#### .需要准备一台有外网ip的服务器
####.提供进行http推送地址校验和接收http数据推送的http服务
####.有人云平台配置Http推送地址

##### 1. 有人IoT-> 扩展功能->http推送: 开通
![](/Public/attached/20210928073519_18964.png)
##### 2.配置Http推送目标地址
> 目标URL格式: {http/https}://{address}:{port}/{path},注:端口号为必须,不能省略

- 全局推送
![](/Public/attached/20210928073554_38034.png)
全局推送：全局推送会向用户指定的url推送该账号下全部设备的数据；

<a name="q4VcN"></a>
### 推送地址校验
打开推送开关的时候会对接口进行校验，会向`用户填写的推送地址`上发送get请求，验证地址的合法性,需要返回相应的数据进行校验。 接口校验方式如下：

| 请求类型 | get |
| --- | --- |
| 请求 | {url}?verify=1234abcd   （随机8位数字或字母） |
| 返回内容 | body为verify的值(如:1234abcd) 注:返回内容只有verify(8个字符)的值,不要加其它任何字符 |

<a name="SY6SM"></a>
### 
<a name="a6efO"></a>
### 推送限制
每个用户每秒最多推送10条数据,超出部分数据会丢失

<a name="tVVC7"></a>
### 接口回复

- 服务器收到http推送后应立即进行回复,推送失败超过10分钟发送报警邮件和短信,超过半小时发送报警邮件和短信并关闭推送开关
- 正常回复`Status Code:200 OK`
- 服务器5秒内没有收到回复视为超时

<a name="697uH"></a>
### http推送格式
类型：post 协议类型：http

| 字段 |  | 说明 |
| :---: | --- | --- |
|  | Content-Type | application/json |
| body |  | json格式 |

<a name="pvn6X"></a>
#### 原始数据
| 类型 | 内容 | | 类型 | 说明 |
| --- | :---: | --- | --- | --- |
| body | type | | transmission | 数据点类型 |
||deviceId||string|设备id|
| | data | | base64 | 透传的数据（转为base64传输） |

<a name="8m3TE"></a>
#### 说明
有人云IoT中绑定模板的设备不推送原始数据

<a name="S1Vg8"></a>
#### 设备数据点上报数据推送
| 类型 | | 内容 | | 类型 | 说明 |
| --- | :---: | :---: | --- | --- | --- |
| body | type | | | dataPoint | 数据点类型 |
| | data | | | | 数据 |
| | | dataPoints | | array | 内容如下 |
| | | | dataPointId | int | 数据点id          |
| | | | slaveName | string | 从机名称 |
| | | | variableName | string | 变量名称 |
| | | | value | string | 数值  |
| | | | err | int | 错误码。 0：正常，非0异常。 1：从机无应答 2：从机给了一个错误应答3：无法连接 4：无此key|
 | | | | time | long | 时间戳（秒) |
| | | deviceId | | string | 设备id |
| | | deviceName | | string | 设备名称 |

`示例:`
```json
{
 "type": "dataPoint",
 "data": {
 "version": 0,
 "dataPoints": [
 {
 "dataPointId": 123123,
 "slaveName": "1",
 "variableName": "123",
 "value": "42.12",
 "err": 0,
 "time": 1539311832
 }
 ],
 "deviceId": "123",
 "deviceName": "balabala"
 }
}
```

<a name="7tzOK"></a>
#### 设备定位数据

| 类型 | | 内容 | | 类型 | |
| --- | :---: | :---: | --- | --- | --- |
| body | type | | | location | 数据点类型 |
| | data | | | | 数据 |
| | | position | | | |
| | | | locationType | string | GPS, Cell等 |
| | | | lng_bd | string | 经度 - 百度 |
| | | | lat_bd | string | 纬度 - 百度 |
| | | | lng_wgs | string | 经度 - 原始 |
| | | | lat_wgs | string | 纬度 - 原始 |
| | | | lng_gcj | string | 经度 - 火星 |
| | | | lat_gcj | string | 纬度 - 火星 |
| | | | time | string | 时间戳（秒) |
| | | deviceId | | string | 设备id |
| | | deviceName | | string | 设备名称 |

`示例：`

```json
{
    "type": "position",
    "data": {
        "version": 0,
        "position": {
            "locationType": "Cell",
            "lngBd": 0,
            "latBd": 0,
            "lngWgs": 0,
            "latWgs": 0,
            "lngGcj": 0,
            "latGcj": 0,
            "time": "1539311832"
        },
        "deviceId": "123",
        "deviceName": "balabala"
    }
}
```