使用 Python 通过 ISAPI 读取海康威视摄像头设备信息

Sun, 25 May 2025 22:42:39 +0800

海康威视（Hikvision）摄像头提供了一套基于 HTTP 的 ISAPI（Intelligent Security API）接口，可以方便地通过程序读取设备信息、配置参数等。本文介绍如何用 Python 通过 ISAPI 接口读取海康摄像头的设备信息。

ISAPI 简介

ISAPI 是海康威视定义的一套 RESTful 风格接口，运行在摄像头的 Web 服务（默认端口 80/443）上。接口路径通常以 /ISAPI/ 开头，请求和响应使用 XML 格式。常见的设备信息接口包括：

接口路径	说明
`/ISAPI/System/deviceInfo`	获取设备基本信息（型号、序列号、固件版本等）
`/ISAPI/System/status`	获取设备运行状态（在线时间、CPU/内存使用率等）
`/ISAPI/System/Network/interfaces`	获取网络接口信息（IP、MAC 等）

认证方式

海康摄像头支持两种 HTTP 认证方式：

HTTP Basic Auth：部分设备或旧固件使用
HTTP Digest Auth：推荐方式，更安全

实际对接中，通常先尝试 Basic Auth，如果返回 401 再降级到 Digest Auth。Python 的 requests 库对两种方式都有良好支持。

实现代码

依赖安装

pip install requests xmltodict

读取单台设备信息

核心思路很简单：构造 ISAPI URL，使用 HTTP Digest 认证发起 GET 请求，解析返回的 XML：

import logging
from ipaddress import ip_address
from requests.auth import HTTPDigestAuth
import requests
import xmltodict

logger = logging.getLogger(__name__)

def get_camera_info(ip, port=80, username="admin", password="your_password") -> dict:
 """通过 ISAPI 读取海康摄像头设备信息"""
 if not isinstance(ip_address(ip), ip_address):
 logger.error("%s 不是合法的 IP 地址", ip)
 return {}

 url = f"http://{ip}:{port}/ISAPI/System/deviceInfo"
 try:
 resp = requests.get(
 url,
 auth=HTTPDigestAuth(username, password),
 timeout=3,
 verify=False,
 allow_redirects=True,
 )
 resp.raise_for_status()
 dev_info = xmltodict.parse(resp.text).get("DeviceInfo", {})
 dev_info["ip"] = str(ip)
 return dev_info
 except Exception as e:
 logger.error("连接 %s 失败: %s", ip, e)
 return {}

调用示例：

info = get_camera_info("192.168.1.64", password="camera_password")
print(info)

返回的数据大致如下（已转为 Python 字典）：

{
 "model": "DS-2CD3T47G2-LU",
 "deviceName": "Camera-01",
 "deviceSerialNumber": "DS-2CD3T47G2-LU20230801AACH12345",
 "macAddress": "A0:BD:1D:XX:XX:XX",
 "firmwareVersion": "V5.7.15",
 "encoderVersion": "V7.1",
 "encoderReleasedDate": "2023-08-01",
 "releaseDate": "2023-08-01",
 "deviceType": "IPC",
 "telecontrolID": "023",
 "supportBeep": "false",
 "supportLED": "true",
 "ip": "192.168.1.64"
}

批量扫描网段

如果需要扫描整个网段中的所有海康摄像头，可以遍历 IP 段并逐一调用：

from ipaddress import ip_network

def scan_cameras(network, port=80, username="admin", password="your_password"):
 """扫描网段内所有海康摄像头"""
 net = ip_network(network, strict=False)
 cameras = []
 for ip in net.hosts():
 print(f"正在扫描 {ip}...")
 info = get_camera_info(str(ip), port, username, password)
 if info:
 cameras.append(info)
 print(f" -> 发现设备: {info.get('model')} ({info.get('deviceName')})")
 return cameras

调用示例：

cameras = scan_cameras("192.168.1.0/24", password="camera_password")
print(f"共发现 {len(cameras)} 台设备")
for cam in cameras:
 print(f" {cam['ip']} - {cam['model']} - SN: {cam.get('deviceSerialNumber')}")

封装为可复用的客户端类

如果需要频繁调用不同的 ISAPI 接口，可以封装一个客户端类，自动处理认证和会话复用：

from urllib.parse import urljoin
from requests.auth import HTTPBasicAuth, HTTPDigestAuth

class HikvisionClient:
 def __init__(self, host, username="admin", password="password", timeout=3):
 self.host = host.rstrip("/")
 self.username = username
 self.password = password
 self.timeout = timeout
 self.session = self._init_session()

 def _init_session(self):
 """初始化会话，自动选择认证方式"""
 url = f"{self.host}/ISAPI/System/status"
 session = requests.session()
 session.auth = HTTPBasicAuth(self.username, self.password)
 resp = session.get(url, verify=False, allow_redirects=True, timeout=self.timeout)
 if resp.status_code == 401:
 session.auth = HTTPDigestAuth(self.username, self.password)
 resp = session.get(url, verify=False, allow_redirects=True, timeout=self.timeout)
 resp.raise_for_status()
 return session

 def get(self, path):
 """调用 ISAPI GET 接口，返回解析后的字典"""
 full_url = f"{self.host}/ISAPI/{path}"
 resp = self.session.get(
 full_url, verify=False, allow_redirects=True, timeout=self.timeout
 )
 resp.raise_for_status()
 return xmltodict.parse(resp.text)

# 使用示例
client = HikvisionClient("http://192.168.1.64", password="camera_password")

# 读取设备信息
device_info = client.get("System/deviceInfo")
print(device_info)

# 读取网络接口信息
network_info = client.get("System/Network/interfaces")
print(network_info)

返回数据说明

/ISAPI/System/deviceInfo 接口返回的关键字段：

字段	说明
`model`	设备型号
`deviceName`	设备名称（用户可自定义）
`deviceSerialNumber`	设备序列号（唯一标识）
`macAddress`	MAC 地址
`firmwareVersion`	固件版本号
`releaseDate`	固件发布日期
`deviceType`	设备类型（IPC/NVR/DVR 等）

注意事项

HTTPS 证书：测试环境中摄像头通常使用自签名证书，代码中 verify=False 会跳过证书验证，生产环境建议配置正规证书
认证失败：默认密码已修改的设备会返回 401，建议先确认认证凭据
超时设置：扫描网段时建议设置较短的超时时间（3 秒），避免长时间等待离线设备
频率限制：大量扫描时建议加入并发控制和延时，避免对网络造成压力
XML 解析：xmltodict 会将 XML 转为 Python 字典，嵌套结构用点号或字典访问

小结

通过海康 ISAPI 接口，几行 Python 代码就能读取摄像头设备信息。核心就是 HTTP + Digest Auth + XML 解析三个要素。将设备信息读取与 NetBox、CMDB 等资产管理系统结合，可以实现摄像头资产的自动化管理和定期巡检。

参考：海康威视 ISAPI 开发指南

Python on HiDa