定义
Webhook 当设备上线/离线、告警触发、OTA 完成等事件发生时，平台向用户配置的 URL 发起 HTTP POST 请求，推送事件数据。用于与 ITSM、Work Order、自建系统集成，由 Rule Engine 触发。
配置与安全
Webhook 需配置目标 URL、请求方法（通常 POST）、可选请求头（如签名、认证 Token）。支持 HMAC 签名验证，接收方可根据签名校验请求来源。建议使用 HTTPS、配置重试策略（如指数退避）、设置超时，确保推送可靠性。失败时可记录日志、告警或进入死信队列供人工处理。
事件类型
常见事件包括：设备上线/离线、属性变更、事件上报、告警触发、OTA 任务状态变更、设备注册/删除等。Webhook payload 通常包含事件类型、时间戳、设备标识、关联数据。接收方可解析 payload 后创建 Work Order 工单、同步至 ITSM、触发业务逻辑或写入数据仓库。
与 OpenAPI 对比
Webhook 为服务端主动推送，适合实时事件驱动；OpenAPI 为客户端主动拉取，适合批量查询与配置。两者互补，Webhook 负责事件通知，OpenAPI 负责数据获取与操作，共同构成平台开放能力。