项目 API


项目 API

支持的运行平台

项目 API 基于标准 HTTP 协议和 MQTT 协议,对于不支持 MQTT@TCP 的浏览器应用,我们提供了 MQTT@Websocket。这使得项目 API 兼容所有应用程序运行平台。

因此,您可以基于 ThingsCloud API 开发出无限扩展的应用软件,包括但不限于以下:

  • 基于 Web 浏览器的 SaaS 软件
  • 运行在桌面的客户端软件
  • 运行在手机端的 App
  • 运行在工业平板上的可视化应用
  • 运行在电视屏上的大屏应用

HTTP API

ThingsCloud 支持 HTTP RESTful API,第三方应用端可通过 API 主动请求项目内的资产信息和数据,大致具有以下能力:

  • 支持服务器端和浏览器端的身份验证。
  • 可读取项目、设备类型、设备、告警、用户、管理员等信息。
  • 可读取设备历史数据。
  • 可向设备下发数据。

提示

项目 HTTP API 面向付费用户开放,详细文档请浏览 HTTP API

实时消息 API

当我们需要在应用中实时更新设备状态,就需要收到云平台的实时消息。ThingsCloud 提供了多种实时消息机制,包括:

  • MQTT 应用端订阅
  • 基于规则引擎的实时消息

除了用于在应用中实时更新设备状态,我们还可以在应用端的服务器程序中接收设备上报的实时消息,进行以下操作:

  • 写入自有时序数据库
  • 实现业务级的规则处理
  • 实现设备联动控制
  • 实现后期的大数据分析和 AI 训练
  • 实现更具个性化的 BI 分析和展示

MQTT 应用端订阅

MQTT 应用端订阅允许应用软件通过 MQTT 协议来订阅实时消息。

提示

MQTT 应用端订阅功能面向付费用户开放,详细文档请浏览 MQTT 应用端订阅

基于规则引擎的实时消息

在介绍规则引擎的时候,我们提到了支持数据流转的相关操作,可以用来帮助应用接收实时消息,这些操作包括:

  • MQTT 转发
  • WebURL 转发

提示

关于规则引擎的数据流转介绍,请浏览 推送到外部 MQTT