入门介绍

HTTP基础知识

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

HTTP身份验证和错误代码

咱们将在本文中应用拜访令牌设施凭证，稍后将它们称为$**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}

附：模仿设施接入示例

模仿HTTP设施接入
文章起源（首发地址）：ThingsKit物联网平台