命令下发
概述
用户可以通过http请求向设备下发数据,目前仅支持数据点数据和透传数据的下发
每个用户每秒最多下发10条数据,超出部分的数据,服务器不处理并返回错误码
操作流程
- 通过获取X-Access-Token获取X-Access-Token
- 获取推送的url,见文档获取命令下发地址,注:该接口有频率限制,获取一次后可重复使用,不需频繁获取
- 按照接口规范推送命令数据(如下)
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 | 数据 |
示例:
{
"setDataPoint": [
{
"dataPointId": 123,
"value": "12.11"
}
]
}
字段 | 说明 | |
---|---|---|
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个字符) |
示例:
{
"data":"YWJjZGVmZw=="
}
回复
错误码
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 | 参数格式错误 |