# 项目 API

# 支持的运行平台

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

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

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

# HTTP API

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

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

# 实时消息 API

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

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

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

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

# MQTT 应用端订阅

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

# 基于规则引擎的实时消息

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

• MQTT 转发
• WebURL 转发