使用文档-命令下发-有人云

# 命令下发

<a name="8NdOJ"></a>
### 概述
用户可以通过http请求向设备下发数据，目前仅支持数据点数据和透传数据的下发
<a name="yXNuN"></a>
每个用户每秒最多下发10条数据，超出部分的数据，服务器不处理并返回错误码
### 操作流程

1. 通过[获取X-Access-Token](http://cloud.usr.cn/document/802.html)获取X-Access-Token
2. 获取推送的url,见文档[获取命令下发地址](http://cloud.usr.cn/document/819.html "获取命令下发地址"),注:该接口有频率限制,获取一次后可重复使用,不需频繁获取
3. 按照接口规范推送命令数据(如下)
<a name="697uH"></a>
### http接口规范
类型：post 协议类型：https
#### 变量数据下发

| 字段 | | 说明 |
| :---: | --- | --- |
| URI | | /v2.0/dataPoint/{cusdeviceNo} ,{cusdeviceNo}为设备编号 示例：/v2.0/dataPoint/0123456789abc|
| header | | 如下 |
| | X-Access-Token | 位于header中,通过api接口获取 必选 |
| | Content-Type | application/json |
| body | | json格式如下 |

* json格式

| 类型 | 字段 |  | 类型 | 说明 |
| --- | :---: | --- | --- | --- |
| body | setDataPoint |  | array | 内容如下 |
|  | | dataPointId | integer | 变量id，和identifier二选一 |
|  | | identifier | string | 变量标识 ，和dataPointId二选一|
|  |  | value | string | 数据 |

示例：

```json
{
 "setDataPoint": [
 {
 "dataPointId": 123,
 "value": "12.11"
 }
 ]
}
```
<a name="bY0Iq"></a>

| 字段 | | 说明 |
| :---: | --- | --- |
| URI | | /v2.0/transmission/{deviceId} ,{deviceId}为网关编号 示例：/v2.0/transmission/123123123|
| header | | 如下 |
| | X-Access-Token | 位于header中,通过api接口获取 必选 |
| | Content-Type | application/json |
| body | | json格式如下 |

##### 透传数据

| 内容 |  | 类型 | 说明 |
| :---: | --- | --- | --- |
| data |  | string | 透传的数据（数据转为base64传输,body最大长度为8000个字符） |

示例：
```json
{
	"data":"YWJjZGVmZw=="
}
```

<a name="he7HT"></a>
### 回复
<a name="UsQLP"></a>
#### 错误码

| http返回码 | 错误码 | 描述 | 说明 |
| --- | --- | --- | --- |
| 404 |  | page not found | 页面找不到 |
| 500 | 500 | Internal server error | 服务器内部错误 |
| 429 | 10001 | Frequency out of limit | 频率超过限制 |
| 401 | 10003 | authorized failed | 权限校验失败 |
| 413 | 10004 | too large content | 数据内容过大 |
| 400 | 10005 |param format error |参数格式错误|