一:CoAP连接
$ACCESS_TOKEN
:访问令牌设备凭证
二:键值格式
- 默认情况选,thingsBoard支持JSON中的键值内容。键始终是一个字符串,而值可以使字符串,布尔值,双精度,长整数或JSON。也可以使用自定义二进制格式或某些序列化框架。
{
"stringKey":"value1",
"booleanKey":true,
"doubleKey":42.0,
"longKey":73,
"jsonKey": {
"someNumber": 42,
"someArray": [1,2,3],
"someNestedObject": {"key": "value"}
}
}
三:遥测上传API
- 连接地址:coap://host/api/v1/
$ACCESS_TOKEN
/telemetry - 请求方式:POST
- 支持最简单数据格式:
{"key1":"value1", "key2":"value2"}
[{"key1":"value1"}, {"key2":"value2"}]
备注 :在这种情况下,中台服务器端时间戳将分配给上传的数据!如果设备能够或得设备端时间戳,则可以使用一下格式
{"ts":1451649600512, "values":{"key1":"value1", "key2":"value2"}}
四: 属性API(ThingsBoard属性API使设备能够)
将设备端设备属性上载到中台服务器端
从中台服务器端请求客户属性和共享设备属性
.从中台服务器端订阅共享的设备属性
- 将属性更新发布到中台服务器端
连接地址:coap://host/api/v1/$ACCESS_TOKEN
/attributes
请求方式:POST
数据格式
{"key1":"value1", "key2":"value2"}
或者
[{"key1":"value1"}, {"key2":"value2"}]
- 从中台服务器端请求属性值
连接地址:
coap://host/api/v1/$ACCESS_TOKEN
/attributes?clientKeys=attribute1,attribute2&sharedKeys=shared1,shared2
请求方式:GET - 从中台服务器端订阅属性更新
订阅地址:coap://host/api/v1/$ACCESS_TOKEN
/attributes