自定义 API 应用

当您需要在自己的系统中对接平台能力（读取设备数据、下发控制指令、同步设备状态等）时，可以创建自定义 API 应用。应用以 API 凭据的形式接入，不提供界面。

创建应用

在「应用 → 应用」中点击「创建应用」，选择 API 应用类型。创建成功后会生成应用的 AppID。

接入方式

自定义 API 应用提供两类对接能力：

项目 HTTP API

使用应用的 appId、accessKey、secretKey 调用 /api/v1/access_token 换取项目 API 访问令牌，即可访问设备管理、设备数据、设备控制、告警和规则等全部项目级接口。

完整的接口清单、参数与示例见 项目 HTTP API。

MQTT 应用端订阅

如需实时接收设备消息（属性上报、事件上报等），可以使用项目级 MQTT 订阅凭据订阅设备消息主题：

• 订阅凭据可通过 HTTP API 的「获取当前项目 MQTT 凭据」接口获取。
• 协议与主题的详细说明见 MQTT 应用端订阅。

使用建议

• secretKey 属于敏感凭据，请只在服务端保存与使用，不要下发到浏览器或 App 客户端。
• HTTP API 适合主动查询与控制，MQTT 订阅适合实时消息推送，两者通常配合使用。
• 高频数据落库、报表等场景，也可以通过消息规则转发到您的服务，无需轮询接口。