通博TBET

通博TBET云二次开发调取命令下发接口

一、资料准备：

通博TBET云网址：http://cloud.ybljg.com/

二次开发文档：http://cloud.ybljg.com/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中填通博TBET云账号，password中填通博TBET云密码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，则证明接口下发成功