有人云二次开发调取命令下发接口
一、资料准备:
有人云网址:http://cloud.usr.cn/
二次开发文档:http://cloud.usr.cn/document/237.html
二、注意:
1、用户可以通过http请求向设备下发数据,目前仅支持数据点数据和透传数据的下发
2、每个用户每秒最多下发10条数据,超出部分的数据,服务器不处理并返回错误码
3、进行二次开发时需要将使用的设备在线
4、流程:
(1)通过用户登陆接口获取token
(2)获取推送的url,获取命令下发地址,注:该接口有频率限制,获取一次后可重复使用,不需频繁获取
(3)按照接口规范推送命令数据
三、具体操作步骤:
1、在接口文档中找到用户登录接口(二次开发-API-用户-用户登录)
将请求URL和请求方式填到postman中
2、在headers中添加Content-Type请求参数,值为application/json
3、将请求示例大括号中得数据复制到body的raw中
account中填有人云账号,password中填有人云密码md5加密之后的密码
设置完成后点击Send,获取生成的token
4、在二次开发文档界面打开获取命令下发地址(二次开发-命令下发-使用文档-获取命令下发地址)
5、将命令下发的请求方式和请求URL填入postman中
在headers中添加Content-Type和token,值分别为application/json以及刚刚获取到的token
生成的token两小时内有效
6、将请求示例复制到body的raw中,之后点击Send,会生成一个链接,这个链接是命令下发地址
7、二次开发文档打开命令下发界面(二次开发-命令下发-使用文档)
命令下发的接口类型为post,协议类型为https
将刚刚生成的命令下发地址复制到新建的窗口的URL中,后边加上/v1.0/{type}/{deviceId}
其中type: dataPoint或transmission(dataPoint:变量数据,transmission:透传数据);deviceId:设备sn
8、在headers中添加Content-Type和token,值分别为application/json以及刚刚获取到的token
生成的token两小时内有效
9、在body中填入示例中的代码
数据透传的话填入"data":"YWJjZGVmZw==",其中data中的数据为透传的数据(数据转为base64传输,最大长度为8000个字符)
组态数据的话,slaveName为从机名称,variableName为变量名称,value为数据本身
10、如果返回200,则证明接口下发成功