安全摄像头的Webhooks和HTTP Push功能
内容提要
本文介绍安全摄像头通过Webhook或HTTP Push向第三方报警平台推送事件通知的功能。相比封闭生态，该功能支持接入第三方系统。实现方案有端侧直推和云端转发两种，前者隐私好但耗电，后者更可靠。安全机制包括HTTPS加密和HMAC签名验证，Payload结构清晰，包含事件信息和媒体链接。
延伸解读
端侧直推与云端转发的取舍
端侧直推架构简单、隐私性好，但每次告警都需在设备端建立TLS/HTTPS握手，对电池供电的摄像头耗电明显，且第三方服务器宕机时易丢消息。云端转发通过长连接先传信号，再由云端组织HTTP POST，可靠性更高，但数据会经过厂商云。选择哪种方案，需在隐私、功耗和可靠性之间权衡。
安全机制的关键点
Webhook通信必须强制使用HTTPS加密，防止中间人攻击。同时，通过HMAC-SHA256签名机制验证消息来源，防止伪造告警。第三方服务器需在后台配置Secret Key，并对收到的请求进行验签。这些机制是保障第三方告警接入安全的基础，缺一不可。
Payload设计要点
Webhook的JSON结构应清晰，便于解析。由于媒体文件体积大，Payload中只包含缩略图或视频的URL，第三方系统收到后按需拉取。字段如eventId、timestamp、deviceSn、eventType等需标准化，以便对接。合理设计Payload能提升集成效率，减少带宽消耗。
Q&A
安全摄像头的Webhook和HTTP Push功能是什么？
安全摄像头的Webhook或HTTP Push功能是指当摄像头检测到事件（如PIR或AI检测）时，自动向预先配置的第三方HTTP服务器发送HTTP请求（通常是POST），以推送事件通知。这使摄像头能够接入第三方中控系统或安保报警平台，而不局限于厂商的封闭生态。
安全摄像头Webhook推送的两种实现方案是什么？各有什么优缺点？
两种方案是端侧直推和云端转发。端侧直推是摄像头直接向第三方URL发送HTTP POST请求，优点是架构简单、隐私性好（数据不经过第三方云），缺点是低功耗电池设备耗电大，且第三方服务器宕机时容易丢消息。云端转发是摄像头通过长连接（如MQTT、WebSocket）将告警发给厂商云，再由云端转发HTTP POST给第三方，优点是更可靠，适合低功耗设备，但数据经过厂商云。
Webhook推送如何保证安全性？
安全性主要通过两种机制：一是强制使用HTTPS加密通信，防止中间人攻击；二是使用HMAC-SHA256签名验证，在HTTP Header中携带X-Signature字段，该字段由请求体与Secret Key计算得出，第三方服务器用相同密钥验签，确保消息来源合法。
Webhook的Payload结构通常包含哪些字段？
Payload通常包含事件ID（eventId）、时间戳（timestamp）、设备序列号（deviceSn）、事件类型（eventType）以及数据（data）字段，其中data字段包含事件截图URL（snapshotUrl）、录像文件URL（videoClipUrl）、电池电量（batteryLevel）和WiFi信号强度（signalStrength）等。
为什么Webhook的JSON结构中通常只包含媒体链接而不直接包含媒体文件？
因为事件缩略图和录像文件体积较大，直接在Webhook中传输会占用大量带宽和存储，所以JSON中只包含缩略图URL或视频下载链接，第三方系统收到Webhook后，再通过链接按需拉取媒体文件。
哪些品牌的安全摄像头支持Webhook推送？
面向企业级和高端商用的品牌如海康、大华、Axis、Meraki等原生支持Webhook/HTTP请求推送；而面向纯C端消费级的品牌如Ring、Arlo、Nest、Eufy、Wyze等大多倾向于封闭生态，不原生开放Webhook。
