最新消息:QQ物联、百度物联网、阿里物联平台、华为物联网、机智云、中国移动物联网开放平台设备云OneNET 等都是我们未来生活中不可缺少的远程平台。我们将在Q物联这里学习使用、利用这些工具技术,甚至开发和创造。

Thingslink 物联网开发平台 控制端APP开发协议说明

Thingslink物联网 Q物联 136浏览 0评论



Thingslink 开发者开发协议

 

本协议可以帮助开发者开发自己的APP 来控制智能终端和开发自己的终端产品。本文档的说明将基于蛋蛋(DD)远程控制平台为例

 

Thingslink 协议有两部分组成

1、API 协议,用户登录和用户信息、终端信息和对应的sensor信息

2、Socket 协议,接入Thingslink 通讯平台,完成终端信息的采集和控制。

 

 

设备终端:socket 协议

App 客户端:http+Socket

 

Socket 协议信息组成

协议长度+命令长度+协议命令+协议数据

协议长度和命令长度均为4个字节的数据,而且为网络小头字节

命令长度=协议命令长度

协议长度(总长度)=命令长度+协议数据长度+4

 

主协议以换行符“\n\t”为分隔,键值对以“=”分隔;信息内容为自定义信息开发者可以自定义(不能使用=号)

 

Socket信息:sip.iot.open.qwulian.cn:5081

Api 信息:tiandong.thingslink.qwulian.cn =({TiandongURL})

 

开发者在Thingslink 开发中心(open.thingslink.qwulian.cn) 获取应用的appkey 及账号信息

App 开发接入

1、认证APP信息,获取app认证token

Http 请求认证:

POST: {TiandongURL}/application.aspx

参数:

FunctionType=ApplicationVerify

Application: App 对应的uuid 开发者中心可以获得

 

Response :

错误格式:

{“ErrorCode”:”400000″,”ErrorMsg”:”非法请求!”,”Data”:””}

正确返回信息:

{

   “Data”: “{\”_appkey\”:null,\”_appsec\”:null,\”_apptoken\”:\”*****************\”,\”_appuuid\”:\”{appuuid}\”,\”_createtime\”:null,\”_isenable\”:false,\”_name\”:\”蛋蛋(Dandan)远程控制\”,\”_useruuid\”:null}”,

   “ErrorCode”: “000000”,

   “ErrorMsg”: “认证成功!”

}

 

App Token: _apptoken的值

 

 

2、认证用户信息,获取用户认证token

    

Http 请求认证:

POST: {TiandongURL}/user.aspx

参数:

FunctionType=Login

UserID:user id(邮箱/手机号)

Password: {用户密码}

AppToken:App 认证获得的app tocken

Response :

错误格式:

{“ErrorCode”:”400000″,”ErrorMsg”:”非法请求!”,”Data”:””}

正确返回信息:

{

   “Data”: “{\”__usertoken\”:\”{user token}\”,\”__useruuid\”:\”{user id}\”,\”__nickname\”:\”test\”}”,

   “ErrorCode”: “000000”,

   “ErrorMsg”: “认证成功!”

}

 

3、获取用户下面的设备列表信息

Http 请求认证:

POST: {TiandongURL}/client.aspx

参数:

FunctionType=GetClientList

UserUUID:user uuid(用户认证中获取)

Password: {用户密码}

AppToken:app 认证获得的app token

 

Response :

错误格式:

{“ErrorCode”:”400000″,”ErrorMsg”:”非法请求!”,”Data”:””}

正确返回信息:

{

   “Data”: “{Client list JsonArray}”,

   “ErrorCode”: “000000”,

   “ErrorMsg”: “认证成功!”

}

注:

{JsonArray}:里面每一个对象Client,包含 _account: Client ID;_name:Client 名称

 

4、添加用户设备信息

需要开发者为自己的应用添加Client 信息,添加后可以提供给本应用的使用者添加认证Client 信息

Http 请求认证:

POST: {TiandongURL}/client.aspx

参数:

FunctionType=CreateClient

UserUUID:user uuid(用户认证中获取)

ClientID:{开发者生成的Client ID}

ClientName:{Client 名称,可以自定义}

Password: {Client 认证码 开发者中心可以获得}

AppToken:app 认证获得的app token

 

Response :

错误格式:

{“ErrorCode”:”400000″,”ErrorMsg”:”非法请求!”,”Data”:””}

正确返回信息:

{

   “Data”: null,

   “ErrorCode”: “000000”,

   “ErrorMsg”: “Client 添加成功!”

}

5、获取每一个Client 设备上对应的Sensors

Http 请求认证:

POST: {TiandongURL}/sensor.aspx

参数:

FunctionType=GetSensorList

UserUUID:user uuid(用户认证中获取)

ClientUUID: {指定设备的UUID,获取client list 中可以获得}

AppToken:app 认证获得的app token

 

Response :

错误格式:

{“ErrorCode”:”400000″,”ErrorMsg”:”非法请求!”,”Data”:””}

正确返回信息:

{

   “Data”: “{Sensor list JsonArray}”,

   “ErrorCode”: “000000”,

   “ErrorMsg”: “认证成功!”

}

注:

{JsonArray}:里面每一个对象Client,包含的信息

 _serialno: {sensor 序号}

_name:Sensor名称

_category: { sensor 种类}

_valuetype:{sensor 值对应的类型}

_svalue:{sensor 对应的值}

 

6、通过app token和user token 来登录Thingslink 即时消息平台

6.1 建立Socket连接平台,验证连接种类

Socket(sip.iot.open.qwulian.cn,5081) 连接,连接后发送终端认证字符socket.send((byte)2) 这个不需要计算长度

 

6.2 验证连接用户和应用信息

发送命令内容:`Command=Login\r\nAppToken=”+appToken+”\r\nUserName=”+userID+”\r\nUserToken=”+userToken+”\r\n

Command: 固定 Login (登录)

AppToken: App 认证时获得的Token

UserToken:用户认证成功时获得Token

UserName: 用户登录使用邮件地址或者手机号

 

7、发送控制信息到设备终端

Command=Route\r\nClientID=\r\nItem=”+itemcontent

Command: Route 固定

ClientID: login 时使用的client ID

Item: 要发送的内容,可以根据自己的协议定义。例如蛋蛋远程为 SensorID:2;Value:25.3 发送sensorid=2 的信息(sensorid 不同的产品定义不同,详见ClientID 对应的sensorid)

 

8、接受Thingslink 平台信息

Command=Route\r\nClientID=\r\nItem=”+itemcontent

Command: Route 固定

ClientID: login 时使用的client ID

Item: 要发送的内容,可以根据自己的协议定义。例如蛋蛋远程为 SensorID:2;Value:25.3 接收到sensorid=2 的信息(sensorid 不同的产品定义不同,详见ClientID 对应的sensorid),值为25.3

 

9、心跳信息发送

Command=Active

Command: Action 固定

6.2/7/8/9 项命令,均需要添加信息长度和命令长度再socket.send(message) message=信息长度+命令长度+命令

更多教程

转载请注明:Q物联网 » Thingslink 物联网开发平台 控制端APP开发协议说明

发表我的评论
取消评论
表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址