AqaraLink 开发者平台 API：能为开发者提供什么
面向集成商的 AqaraLink 开发者平台 API 详解：云端模块、消息推送、虚拟账号、App SDK 与 Matter 路径，附马来西亚支持信息。
开发者与集成商
马来西亚公寓物业管理的智能家居整合
简要回答 — Aqara 开发者平台的文档说明，项目可以通过 Aqara API 与物业管理系统对接，实现设备的实时监控和远程操作。实际做法是：物业管理系统（PMS）保存单位和住户信息，Aqara API 保存设备信息，再由一个映射层把两者连起来。公共区域或单位内装修中的任何市电工程，仍必须由在 Suruhanjaya Tenaga（马来西亚能源委员会）注册的持牌电工（wireman）完成。
本文是什么，不是什么
本文说明的是能力和整合路径，不是案例研究，因为我们不会为您编造案例。如果您需要数据，例如类似项目管理多少个单位、投资回报如何、某个具体部署达成了什么，请直接询问团队，我们只会提供我们能够负责的内容。
这项能力有文档依据：Aqara 开发者平台支持通过 Aqara API 把项目与物业管理系统对接，提供设备的实时监控和远程操作。
公寓真正需要的三件事
撇开营销话术，物业管理系统需要智能家居层提供三样东西。
1. 设备状态监控
不是给住户看的、带漂亮图块的仪表板，而是运维视图：这台设备在线吗？有在上报吗？上报的内容有异常吗？是不是 12-14 单位那台自星期二起就没有动静的设备？
Aqara 的云端 API 提供设备状态和资源状态，消息推送服务则把设备上报的数据发送到您的服务器。两者结合，才使楼栋规模的监控可行：事件靠推送，整体状态靠查询。一台网关最多可控制 128 台相关设备，所以只要规划得当，共用的大堂、健身房、泳池平台、信箱室和停车场闸门只需一台网关处理；规划不当，就要好几台。
2. 远程操作
例如关闭空置单位的热水器或空调，看房前检查门磁传感器，或重置已跳脱的设备。云端 API 支持设备的远程控制，PMS 或员工手机应用就是调用它。
坦白地说：远程控制很方便，但不能取代现场到场。持牌电工仍然必须到场。远程控制带来的改变是，因为诊断已经完成，所需的上门次数减少了。
3. 账号绑定
这是最难的部分，也决定了您的项目三年后是否还能维护。
PMS 有自己的登录系统。住户不想多一个 Aqara 账号，楼宇管理层也不应该手动维护 900 个消费者账号。Aqara 开发者文档介绍了虚拟账号授权模式，专门用于对接第三方账号系统。PMS 中的住户记录映射到一个虚拟 Aqara 账号；映射表由您掌握；平台永远看不到住户的真实登录凭证。
请在第一天就规划好这个映射。配置完成后再补做，是公寓整合项目停滞最常见的原因。
整合路径
| 步骤 | 内容 | 所在位置 |
|---|---|---|
| 1. 范围 | 确定范围：单位内装修、公共区域，还是两者 | 您的项目 |
| 2. 网关位置 | 在施工阶段确定网关位置、电源和网络 | 楼宇设备图纸 |
| 3. 授权 | 楼栋整体采用项目授权，住户采用虚拟账号 | Aqara 平台 + 您的映射表 |
| 4. 入网 | 批量导入设备，或在交楼时通过应用/SDK 配对 | Aqara 平台 |
| 5. PMS 映射 | 把单位记录与设备记录对应起来 | 您的后台 |
| 6. 推送端点 | 接收设备事件，决定部署位置 | 您的服务器 |
| 7. 运维 | 固件政策、维护时段、转售时由谁重新配对 | 写成文件，而不是留在某人脑子里 |
第 5 步要放慢节奏。它不起眼，却是项目真正出问题的地方。
合规的现实
市电工程不能自己动手，也没有商量余地
马来西亚使用 230V 单相电。公寓单位的照明通常在天花灯座（ceiling rose）处采用环入式布线，只有一条开关线降到墙上，所以开关底盒里只有火线和控制火线，没有零线。传统智能开关需要零线，而马来西亚建筑里的底盒往往很浅，模块加上原有导线根本塞不进去。
固定电气工程必须由在 Suruhanjaya Tenaga（能源委员会）注册的持牌电工（wireman）依照 Electricity Supply Act 1990 (Act 447) 进行。 接错零线有火灾和触电风险，而自行进行市电工程如造成损坏，还可能令家居保险失效。
对发展商或物业管理公司（PMC）来说，实际做法是：您的电气承包商才是判断该开关位置是否有零线的人。请在装修之前让他们检查，而不是事后。同时要确认任何市电供电的产品都带有 SIRIM 标签并获得 Energy Commission 批准。
公共区域摄像头与 PDPA
PDPA 2010 (Act 709) 适用于在住宅或公共区域录像或进行人脸识别的设备。大堂摄像头和人脸识别门锁都在这个范围之内。
安装之前要先厘清三件事：
- 明确的用途是什么，告知了哪些人
- 录像存放在哪里，谁可以查看
- 单位转售或租约结束时，这些数据如何处理
关于相关义务以及如何正确核查，我们在 SIRIM、Suruhanjaya Tenaga 与 PDPA 合规清单中有说明。请不要根据博客文章（包括本文）来确定合规立场，请以现行条文为准。
要规定哪些，日后才能整合
“改装（retrofit）”是这个行业里最昂贵的词。如果楼栋正在兴建，以下几项几乎不花钱：
- 每个开关位置都预留零线
- 网线布到网关位置，以及闸门、前门和摄像头位置
- 预留适合智能模块的底盒深度
- 为任何墙面控制器确定面板位置
这份清单在交楼规格文章中有更详细的展开。如果楼栋已经落成，请预算开槽以及持牌电工的费用。
开发者平台的定位
API 的技术形态，包括模块、消息推送、虚拟账号、SDK 以及 Matter 控制器要求，在 AqaraLink 开发者平台一文中有详细介绍。对于运营方而非开发者，酒店与办公室一文则从运营角度介绍同一平台。
