HTTP对接

HTTP对接说明

• 本章介绍设备通过 HTTP 上报属性与事件的接口，上报参数与 MQTT 格式一致。
• 应用侧 OpenAPI 还提供设备查询、注册、控制与影子等接口，接口清单可在 blade-server 的 /swagger-ui.html 查看。

一、设备属性数据上报

• URL模板：https://${域名}/blade-iot/openapi/thing/sys/{productKey}/{deviceName}/thing/property/post
• HTTP方法：POST
• 请求数据格式：

{
  "id": "",
  "version": "",
  "sys": {
    "ack": 0
  },
  "method": "",
  "params": {}
}

• 响应数据格式：

{
  "id": "",
  "version": "",
  "code": 0,
  "message": "",
  "method": "",
  "data": {},
  "resultCode": {
    "code": 0,
    "message": ""
  }
}

二、设备事件数据上报

• URL模板：https://${域名}/blade-iot/openapi/thing/sys/{productKey}/{deviceName}/thing/event/{identifier}/post
• HTTP方法：POST
• 请求数据格式：

{
  "id": "",
  "version": "",
  "sys": {
    "ack": 0
  },
  "method": "",
  "params": {}
}

• 响应数据格式：

{
  "id": "",
  "version": "",
  "code": 0,
  "message": "",
  "method": "",
  "data": {},
  "resultCode": {
    "code": 0,
    "message": ""
  }
}

三、设备命令响应数据上报

• URL模板：https://${域名}/blade-iot/openapi/thing/sys/{productKey}/{deviceName}/thing/command/{identifier}/post
• HTTP方法：POST
• 请求数据格式：

{
  "id": "",
  "version": "",
  "sys": {
    "ack": 0
  },
  "method": "",
  "params": {}
}

• 响应数据格式：

{
  "id": "",
  "version": "",
  "code": 0,
  "message": "",
  "method": "",
  "data": {},
  "resultCode": {
    "code": 0,
    "message": ""
  }
}