ThingsCloud API 概述

ThingsCloud API 为您提供了一个更加灵活、强大且易于集成的物联网平台，以支持各种行业和企业开发和部署个性化的物联网解决方案，这不仅加速了物联网应用的开发过程，还大大降低了企业开发定制化解决方案的技术门槛和成本。

总的来说，ThingsCloud API 为各行业客户打开了通向物联网世界的大门，帮助他们能够以前所未有的方式连接和智能化各种产品和服务，推动业务创新和增长。

支持的协议和运行平台

ThingsCloud API 几乎可以用于任何应用开发平台，这得益于我们支持多种形式的 API，例如：

• HTTP RESTful API
• HTTP Webhook
• MQTT
• MQTT@Websocket

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

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

项目应用 HTTP API

ThingsCloud 项目应用 HTTP API 为定制开发提供了非常全面的资源访问接口，包括对项目、设备类型、设备组、设备信息、设备扩展信息、设备数据、设备通信、设备告警、用户等全面的资源访问，采用 HTTP RESTful API 风格。

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

• 支持服务器端和浏览器端的身份验证。
• 可读取项目信息、设备类型、设备组、设备信息、设备数据、设备扩展信息、设备告警、用户、管理员等信息。
• 可读取设备历史数据。
• 支持设备通信，可向设备下发属性、下发命令、下发自定义数据（支持 JSON /HEX / Plaintext）。

应用端设备访问 API

ThingsCloud 应用端设备访问 API 提供了一套面向设备的访问接口，帮助您在应用端通过 HTTP 协议快捷的访问设备，包括向设备下发属性、更新属性、下发命令、下发自定义数据等。

MQTT 应用端订阅

MQTT 应用端订阅是一种实时消息 API，它允许您的应用软件通过 MQTT 协议来订阅设备的实时消息。应用软件可以是：

• 服务器应用
• Web 前端应用
• App 应用

通过这种实时消息 API，第三方应用可以实时更新设备状态，还可以在服务器应用中接收实时消息，进行更多操作：

• 将设备数据写入自己的数据库
• 将设备数据导出各种自定义的报表形式
• 实现定制化的业务处理
• 实现个性化的设备联动控制
• 实现大数据分析和 AI 模型训练
• 实现更具个性化的 BI 分析和展示

消息规则的流转操作

通过消息规则的流转操作，也可以帮助应用接收实时消息，但相比 MQTT 应用端订阅，这种方式只限于设备属性上报和事件上报的消息流转。

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

• 转发到 MQTT Broker
• 转发到 URL