博客

ISAPI 报警集成

hanghai tian

• 阅读时间 2 分钟
分享

入侵报警协议 — ISAPI 报警集成

文档版本: V1.0
适用范围: 海康报警主机第三方集成 / 视频+报警融合
编写日期: 2026-06-12

1. 概述

ISAPI（Internet Security API）是海康威视设备的标准 HTTP RESTful 接口，遵循 ONVIF Profile，支持入侵报警主机的事件订阅推送和远程管理。适用于第三方平台集成海康报警主机，尤其适合视频+报警融合联动场景。

2. 技术原理

项目 说明
传输层 HTTP/HTTPS（80/443）
数据格式 XML/JSON
认证 HTTP Digest 认证
通信模型 事件订阅推送（长连接）
版本 ISAPI 2.x / ONVIF 22.x

2.1 事件推送格式（XML）

<EventNotification>
  <EventType>AlarmInput</EventType>
  <DeviceID>DS-PA2026XXXX</DeviceID>
  <AlarmInputPort>1</AlarmInputPort>
  <Timestamp>2026-06-12T10:30:00Z</Timestamp>
</EventNotification>
事件类型 含义
AlarmInput 入侵报警输入
VideoAlarm 视频移动侦测报警
MotionDetection 动态检测
VideoLoss 视频丢失

2.2 订阅与推送流程

第三方平台                       海康报警主机
   │                                  │
   │── HTTP Digest 认证登录 ────────►│
   │                                  │
   │── POST /Event/notification/     │
   │    <EventSubscription>           │
   │    订阅: AlarmInput, VideoAlarm │
   │────────────────────────────────►│
   │◄──── 200 OK (订阅成功) ────────│
   │                                  │
   │  (报警触发时)                    │
   │◄──── POST /Event/notification/  │
   │      <EventNotification> XML    │
   │── 200 OK (确认接收) ──────────►│

3. ISAPI 报警能力

功能 支持 说明
实时报警推送 ✅ HTTP 长连接推送
远程布撤防 ✅ POST /ISAPI/AccessControl/Alarm
防区状态查询 ✅ GET /ISAPI/Status/AlarmInput
报警联动视频 ✅ 同一 ISAPI 体系，无需转换
远程配置 ✅ 设备参数在线修改
多事件订阅 ✅ 同时订阅报警、视频、门禁事件

4. 配置要求

设备端

参数 说明
ISAPI 服务 默认开启（HTTP 80/HTTPS 443）
用户权限 需创建 API 用户（Operator/Admin）
事件订阅 通过 POST 创建订阅
推送目标 第三方平台回调 URL

平台端

参数 说明
监听端口 自定义 HTTP 端口
认证 Digest 用户名密码
解析 XML/JSON 解析库
重连 检测推送超时自动重连

5. 优缺点

优点 缺点
标准化开放，文档公开 实时性依赖 HTTP 网络
事件订阅推送，无需轮询 XML 解析开销较大
与海康视频/门禁统一接口 仅海康设备支持
HTTPS 加密传输 推送失败需实现重试机制
支持远程配置管理 设备端需要网络可达

6. 适用场景

  • 第三方平台集成海康报警主机
  • 视频+报警融合联动（ISAPI 天然优势）
  • 需要远程布撤防和配置管理的场景
  • 不依赖海康 iVMS-4200 的自主平台开发
苏ICP备19018690号-1