2021-09-22
2422
一、资料准备：
凯发K8云网址：http://cloud.a3photo.net/
二次开发文档：http://cloud.a3photo.net/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中填凯发K8云账号，password中填凯发K8云密码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，则证明接口下发成功
