关于物联网:ThingsKit物联网平台设备HTTP接入

5次阅读

共计 1177 个字符，预计需要花费 3 分钟才能阅读完成。

HTTP 是一种通用网络协议，可用于物联网应用程序。HTTP 协定基于 TCP，并应用申请 - 响应模型。
ThingsKit服务器节点充当反对 HTTP 和 HTTPS 协定的 HTTP 服务器。
对于一些十分繁多的利用场景，比方只须要定期采集上报数据，不论是疾速开发原型，还是小规模的利用，设施应用 HTTP 接入云平台也是不错的抉择。
事实上，将 HTTP 协定的简略易用施展到极致，便是 CoAP 协定，对于低功耗设施的繁多数据上报，应用 CoAP 更加符合要求。

咱们将在本文中应用拜访令牌设施凭证，稍后将它们称为 $**ACCESS_TOKEN。** 应用程序须要在每个 HTTP 申请中蕴含 **$ACCESS_TOKEN** 作为门路参数。可能的错误代码及其起因：

400 有效申请 – 有效的 URL、申请参数或注释。
401 未经受权– 有效的$ACCESS_TOKEN。
404 未找到 – 未找到资源。
:::info
💡 提醒
设施应用 HTTP 接入 ThingsKit 平台，其产品协定应用默认即可。
:::

遥测数据上传接口

为了将遥测数据公布到 ThingsKit 服务器节点，请向以下 URL 发送 POST 申请：
```
http(s)://host:port/api/v1/$ACCESS_TOKEN/telemetry
```
最简略的反对数据格式是：
```
{"key1":"value1", "key2":"value2"}
```
或者
```
[{"key1":"value1"}, {"key2":"value2"}]
```
请留神 ，在这种状况下，服务器端工夫戳将调配给上传的数据！
如果您的设施可能获取客户端工夫戳，您能够应用以下格局：
```
{"ts":1451649600512, "values":{"key1":"value1", "key2":"value2"}}
```
调用管制接口

服务器端下发 RPC 命令

以下演示通过 Apifox 发送的 HTTP 遥测数据，通过浏览器进行的 RPC 命令订阅，订阅地址请参考 客户端订阅 RPC 命令

客户端订阅 RPC 命令

用户可从服务器订阅 RPC 命令，发送带有可选“timeout”申请参数的 GET 申请到以下 URL：
```
http(s)://host:port/api/v1/$ACCESS_TOKEN/rpc?timeout=2000
```
一旦订阅，如果没有对特定设施的申请，客户端可能会收到 RPC 申请或超时音讯。RPC 申请体示例如下所示：
```
{
  "id": "1",
  "DO1":true
}
```
id – 申请 id，整数申请标识符；可用于双向命令的响应。除开 id 以外的数据，均为用户输出的数据。

客户端 RPC 命令响应

能够应用 POST 申请对以下 URL 进行回复：
```
http(s)://host:port/api/v1/$ACCESS_TOKEN/rpc/{$id}
```