物联网平台支持设备使用 Socket 协议接入,socket是在应用层和传输层之间的一个抽象层,它把TCP/IP层复杂的操作抽象为几个简单的接口供应用层调用已实现进程在网络中通信。具体通信流程可参考下图。
Socket协议设备接入 - 图1

连接前准备

设备接入前,需要明确设备接入到哪个产品下,如果还未创建产品,请先在安服优物联云创建产品,获取对应的 productKey;设备接入时需要对应设备的 deviceName、secret;设备需要提前在平台进行注册。

Socket 接入地址

47.102.120.143 ,端口号 8182

设备鉴权

在设备连接接入时,安服优物联云使用所接入产品的 productKey、设备的 deviceName 和设备的 deviceSecret 进行鉴权。

传输内容格式

平台支持两种内容传输格式,如下:

  1. 标准JSON格式,示例 {“a”:”123”,”b”:”456”} 推荐格式!
  2. BJSON格式,示例 length{“a”:”123”}%,其中length是整个JSON内容的长度,包含“{}”,”,”,”:”等符号;length为4位整型,不足4位补0;以%结尾

    连接步骤

  3. 设备发出连接

  4. 发送第一次请求登录,请求参数必须要带上productKey,deviceName,deviceSecret 如下:

{“p-k”:”productKey”,”d-n”:”deviceName”,”d-s”:”deviceSecret”}
3 . 服务器进行鉴权,校验通过响应token 如下:
tokendasdad13123131313131
4 . 开始进行业务数据传输通信,如下
{
“p-k”:”productKey”,
“d-n”:”deviceName”,
“d-s “:”deviceSecret”,
“t-k”:”tokendasdad13123131313131”,
“其他业务数据Key”:”值”
}
注意:t-k字段除了在第一次请求登录不需要带上,在其他请求消息中必须要设置。其中 productKey,deviceName,deviceSecret 在所有请求都必须带上,属于必传项。

  • 请求参数说明

p-k String 物联网平台创建产品系统生成的productKey
d-n String 物联网平台创建设备所设置deviceName
d-s String 物联网平台创建设备系统生成的deviceSecret
t-k String 设备第一次请求登录,物联网平台响应的token

返回状态

  • 403 请求不合法