header_logo
header_logo

使用文档

命令下发

概述

用户可以通过http请求向设备下发数据,目前仅支持数据点数据和透传数据的下发

每个用户每秒最多下发10条数据,超出部分的数据,服务器不处理并返回错误码

操作流程

  1. 通过获取X-Access-Token获取X-Access-Token
  2. 获取推送的url,见文档获取命令下发地址,注:该接口有频率限制,获取一次后可重复使用,不需频繁获取
  3. 按照接口规范推送命令数据(如下)

    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 数据

示例:

  1. {
  2. "setDataPoint": [
  3. {
  4. "dataPointId": 123,
  5. "value": "12.11"
  6. }
  7. ]
  8. }

字段 说明
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个字符)

示例:

  1. {
  2. "data":"YWJjZGVmZw=="
  3. }

回复

错误码


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 参数格式错误
方案咨询
联系方式