跳到主要内容

简介

概述

Aqara 数据转出 API 提供了一套丰富的接口,支持用户高效、安全地访问和管理 Aqara Studio 内的设备、空间与自动化相关的数据。通过这些 API,用户可以实现空间和设备的查询、设备的远程控制、Trait 功能点的读取与下发,以及自动化规则的创建、查询、更新和删除等操作。无论是进行设备管理还是构建自动化场景,数据转出 API 都能为开发者提供基础能力,助力快速集成和扩展 Aqara 平台的数据与服务。

HTTP API 列表

空间

功能API 端点请求方法
查询空间列表/open/api/v1/spacesGET

设备

功能API 端点请求方法
查询设备类型列表/open/api/v1/device-typesGET
查设备信息列表/open/api/v1/devicesGET
查询设备详细信息/open/api/v1/devices/definitionsGET
通过 Trait 控制设备/open/api/v1/devices/trait/executePOST
查询 Trait 值/open/api/v1/devices/trait/readPOST
通过 Command 控制设备/open/api/v1/devices/command/executePOST

自动化

功能API 端点请求方法
查询所有支持自动化的设备功能点/open/api/v1/automations/capabilitiesGET
创建自动化/open/api/v1/automationsPOST
查询自动化列表/open/api/v1/automationsGET
查询自动化详情/open/api/v1/automations/<automationId>GET
编辑自动化/open/api/v1/automations/<automationId>PATCH
批量更新自动化状态/open/api/v1/automations/statusPOST
批量更新自动化关联空间/open/api/v1/automations/spacePOST
删除自动化/open/api/v1/automations/deletePOST
查询自动化手动触发对象列表/open/api/v1/automations/manual-triggersGET
执行手动触发器/open/api/v1/automations/manual-triggers/executePOST