平台对接通用指引

微光提供 SaaS / PaaS / AIoT 平台及开放接口，可与既有系统无缝对接。典型对接分为三步：

一、对接准备

1. 在微光云平台创建企业空间，获取 API Key 与设备分组 ID；

2. 梳理既有系统的人员/权限/设备主数据字段，确认映射关系；

3. 规划网络：设备侧需可访问平台 HTTPS 接入地址（支持专线/VPC 互联）。

二、数据同步

人员与权限通过平台「组织同步」接口批量下发，支持增量与全量；开门记录、告警实时回传，可在既有运维平台订阅 Webhook 或拉取。

三、联调与验收

建议先在测试企业空间完成端到端联调（注册→下发→通行→记录回传），再切换生产空间。详细字段与示例见各产品手册与开放 API 文档。