ONVIF 接口
这一层处理摄像机发现、能力读取、Profile、媒体地址、PTZ、图像参数、事件、预置位和对讲。先读设备能力再显示控制按钮，不能假设所有摄像机都支持同一套功能。
本页覆盖 99 个接口。每一行都回答五件事：接口地址、它做什么、何时调用、如何确认完成、谁可以调用。参数字段的精确定义以同版本 OpenAPI 为准。
“业务接口”可以由 WebUI 或第三方系统按权限调用；“管理员接口”需要后台管理员；“内部接口/内部回调”只允许产品组件之间使用。
ONVIF 设备
| 接口 | 讲人话 | 什么时候用 | 调完看什么 | 身份 / 权限 | 主要输入 |
|---|---|---|---|---|---|
POST /api/v2/onvif/capabilities/results |
回填 ONVIF 设备能力结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifCapabilitiesResultRequest |
POST /api/v2/onvif/device-information/results |
回填 ONVIF 设备信息结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifDeviceInformationResultRequest |
GET /api/v2/onvif/devices |
查询 ONVIF 设备列表。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>devices.view |
page、pageSize、status、remoteAddress、remotePort、keyword |
POST /api/v2/onvif/devices |
保存 ONVIF 设备。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
SaveOnvifDeviceRequest |
POST /api/v2/onvif/devices/{deviceId}/bind-channel |
将 ONVIF 视频流地址 绑定为统一视频通道。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifBindChannelRequest |
POST /api/v2/onvif/devices/{deviceId}/bind-channels |
批量绑定 ONVIF 视频通道。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceBindVideoChannelsRequest |
POST /api/v2/onvif/devices/{deviceId}/channels/{channelId}/imaging/focus/native |
操作 ONVIF Profile Imaging 能力、参数和参数套餐。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、channelId（必填）、OnvifProfileFocusExecuteRequest |
POST /api/v2/onvif/devices/{deviceId}/channels/{channelId}/media-uris/refresh |
刷新 ONVIF Profile 流与快照地址。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、channelId（必填）、OnvifProfileMediaUrisRefreshRequest |
POST /api/v2/onvif/devices/{deviceId}/channels/{channelId}/media/synchronization-point/native |
请求 ONVIF Profile 输出同步点/关键帧。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、channelId（必填）、OnvifProfileSynchronizationPointRequest |
POST /api/v2/onvif/devices/{deviceId}/channels/{channelId}/ptz/native |
操作 ONVIF Profile 云台动作 动作。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>devices.manage |
deviceId（必填）、channelId（必填）、OnvifProfilePtzExecuteRequest |
POST /api/v2/onvif/devices/{deviceId}/channels/{channelId}/ptz/presets/refresh |
刷新 ONVIF Profile 云台动作 预置位并落库。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>devices.manage |
deviceId（必填）、channelId（必填）、OnvifPtzPresetsRefreshRequest |
POST /api/v2/onvif/devices/{deviceId}/device-io/refresh |
操作 ONVIF 设备直接刷新继电器输出和数字输入。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceIoRefreshRequest |
POST /api/v2/onvif/devices/{deviceId}/events/properties/refresh |
刷新 ONVIF 设备事件能力并回填设备画像。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifEventPropertiesRefreshRequest |
POST /api/v2/onvif/devices/{deviceId}/events/pull |
拉取 ONVIF 事件拉取。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifPullEventsRequest |
POST /api/v2/onvif/devices/{deviceId}/events/subscriptions |
创建或替换 ONVIF 事件拉取 托管订阅。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifEventSubscriptionRequest |
POST /api/v2/onvif/devices/{deviceId}/media-sources/refresh |
刷新 ONVIF 音视频源。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifMediaSourcesRefreshRequest |
POST /api/v2/onvif/devices/{deviceId}/media-uris/refresh |
批量刷新 ONVIF Profile 流与快照地址。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceMediaUrisRefreshRequest |
POST /api/v2/onvif/devices/{deviceId}/network/default-gateway/native |
原生设置 ONVIF 设备默认网关。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceSetNetworkDefaultGatewayRequest |
POST /api/v2/onvif/devices/{deviceId}/network/dns/native |
原生设置 ONVIF 设备 DNS 配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceSetDnsRequest |
POST /api/v2/onvif/devices/{deviceId}/network/hostname/native |
原生设置 ONVIF 设备主机名。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceSetHostnameRequest |
POST /api/v2/onvif/devices/{deviceId}/network/ntp/native |
原生设置 ONVIF 设备 NTP 配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceSetNtpRequest |
POST /api/v2/onvif/devices/{deviceId}/network/protocols/native |
原生设置 ONVIF 设备网络协议端口。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceSetNetworkProtocolsRequest |
POST /api/v2/onvif/devices/{deviceId}/profiles/refresh |
操作 ONVIF 设备直接刷新 媒体配置档。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifProfilesRefreshRequest |
POST /api/v2/onvif/devices/{deviceId}/relay-outputs/{relayToken}/state |
原生设置 ONVIF 继电器输出状态。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、relayToken（必填）、OnvifDeviceRelayOutputStateRequest |
POST /api/v2/onvif/devices/{deviceId}/services/refresh |
操作 ONVIF 设备直接刷新 服务地址。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifServicesRefreshRequest |
POST /api/v2/onvif/devices/{deviceId}/stream-uri |
通过流媒体服务创建 ONVIF 视频流地址 命令。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifStreamUriRequest |
POST /api/v2/onvif/devices/{deviceId}/system/reboot/native |
操作 ONVIF 设备重启。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceSystemRebootRequest |
POST /api/v2/onvif/devices/{deviceId}/users/create/native |
原生创建 ONVIF 设备用户。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceCreateUsersRequest |
POST /api/v2/onvif/devices/{deviceId}/users/delete/native |
原生删除 ONVIF 设备用户。 | 用户明确确认删除或清理后调用；调用前应先展示影响范围。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceDeleteUsersRequest |
POST /api/v2/onvif/devices/{deviceId}/users/set/native |
原生修改 ONVIF 设备用户。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
deviceId（必填）、OnvifDeviceSetUserRequest |
POST /api/v2/onvif/digital-inputs/results |
回填 ONVIF 数字输入 数字输入结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifDigitalInputsResultRequest |
POST /api/v2/onvif/discovery/results |
导入 ONVIF 发现结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.manage |
OnvifDiscoveryResultRequest |
POST /api/v2/onvif/discovery/start |
通过流媒体服务创建 ONVIF 设备发现命令。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>devices.manage |
OnvifDiscoveryRequest |
POST /api/v2/onvif/dns/results |
回填 ONVIF DNS 配置 配置结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifDnsResultRequest |
GET /api/v2/onvif/event-subscriptions |
查询 ONVIF 事件拉取 托管订阅。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>devices.view |
page、pageSize、deviceId、channelId、status |
POST /api/v2/onvif/event-subscriptions/{subscriptionId}/cancel |
取消 ONVIF 事件拉取 托管订阅。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
subscriptionId（必填） |
POST /api/v2/onvif/event-subscriptions/process-due |
处理到期 ONVIF 事件订阅。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
maxCount |
POST /api/v2/onvif/events/report |
回填 ONVIF 事件消息结果。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifEventReportRequest |
POST /api/v2/onvif/hostname/results |
回填 ONVIF 主机名 主机名结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifHostnameResultRequest |
POST /api/v2/onvif/native/audio-sources |
查看ONVIF 音频输入源。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetMediaSourcesRequest |
POST /api/v2/onvif/native/capabilities |
查看ONVIF 设备能力。 | 在展示功能、生成表单或发起控制前，先用它确认当前版本和目标设备真正支持什么。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetCapabilitiesRequest |
POST /api/v2/onvif/native/device-information |
查看ONVIF 设备信息。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetDeviceInformationRequest |
POST /api/v2/onvif/native/digital-inputs |
查看ONVIF 数字输入。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetDigitalInputsRequest |
POST /api/v2/onvif/native/discovery |
发现 ONVIF 设备。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.manage |
OnvifNativeDiscoveryRequest |
POST /api/v2/onvif/native/dns |
查看ONVIF DNS 配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetDnsRequest |
POST /api/v2/onvif/native/dns/set |
设置 ONVIF DNS 配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifSetDnsRequest |
POST /api/v2/onvif/native/events/create-pull-point-subscription |
创建 ONVIF 事件拉取订阅。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifCreatePullPointSubscriptionRequest |
POST /api/v2/onvif/native/events/properties |
查看ONVIF 事件能力。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetEventPropertiesRequest |
POST /api/v2/onvif/native/events/pull-messages |
拉取 ONVIF 事件消息。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifPullMessagesRequest |
POST /api/v2/onvif/native/events/renew |
续期 ONVIF 事件订阅。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifRenewRequest |
POST /api/v2/onvif/native/events/unsubscribe |
取消 ONVIF 事件订阅。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifUnsubscribeRequest |
POST /api/v2/onvif/native/hostname |
查看ONVIF 主机名。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetHostnameRequest |
POST /api/v2/onvif/native/hostname/set |
设置 ONVIF 主机名。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifSetHostnameRequest |
POST /api/v2/onvif/native/imaging |
原生 SOAP 调用完整 ONVIF Imaging 标准操作。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifNativeImagingRequest |
POST /api/v2/onvif/native/network-default-gateway |
查看ONVIF 默认网关。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetNetworkDefaultGatewayRequest |
POST /api/v2/onvif/native/network-default-gateway/set |
设置 ONVIF 默认网关。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifSetNetworkDefaultGatewayRequest |
POST /api/v2/onvif/native/network-interfaces |
查看ONVIF 网卡配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetNetworkInterfacesRequest |
POST /api/v2/onvif/native/network-protocols |
查看ONVIF 网络协议和端口。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetNetworkProtocolsRequest |
POST /api/v2/onvif/native/network-protocols/set |
设置 ONVIF 网络协议和端口。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifSetNetworkProtocolsRequest |
POST /api/v2/onvif/native/ntp |
查看ONVIF NTP 时间服务器。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetNtpRequest |
POST /api/v2/onvif/native/ntp/set |
设置 ONVIF NTP 时间服务器。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifSetNtpRequest |
POST /api/v2/onvif/native/profiles |
查看ONVIF 媒体配置档。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetProfilesRequest |
POST /api/v2/onvif/native/ptz |
执行 ONVIF 云台控制。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>devices.control |
OnvifNativePtzRequest |
POST /api/v2/onvif/native/relay-output-state |
设置 ONVIF 继电器输出状态。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifSetRelayOutputStateRequest |
POST /api/v2/onvif/native/relay-outputs |
查看ONVIF 继电器输出。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetRelayOutputsRequest |
POST /api/v2/onvif/native/scopes |
查看ONVIF 设备作用域。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetScopesRequest |
POST /api/v2/onvif/native/service-capabilities |
查看ONVIF 服务能力。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetServiceCapabilitiesRequest |
POST /api/v2/onvif/native/services |
查看ONVIF 服务地址。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetServicesRequest |
POST /api/v2/onvif/native/set-synchronization-point |
设置 ONVIF 视频同步点（关键帧）。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifNativeSetSynchronizationPointRequest |
POST /api/v2/onvif/native/smoke-test |
对指定 ONVIF 目标设备执行原生信令烟测。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifSmokeTestRequest |
POST /api/v2/onvif/native/snapshot-uri |
查看ONVIF 快照地址。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifNativeSnapshotUriRequest |
POST /api/v2/onvif/native/stream-uri |
查看ONVIF 视频流地址。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifNativeStreamUriRequest |
POST /api/v2/onvif/native/system-date-time |
查看ONVIF 系统日期时间。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetSystemDateAndTimeRequest |
POST /api/v2/onvif/native/system-log |
查看ONVIF 设备系统日志。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetSystemLogRequest |
POST /api/v2/onvif/native/system-reboot |
操作 ONVIF 设备重启。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifNativeSystemRebootRequest |
POST /api/v2/onvif/native/users |
查看ONVIF 设备用户。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetUsersRequest |
POST /api/v2/onvif/native/users/create |
创建 ONVIF 设备用户。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifCreateUsersRequest |
POST /api/v2/onvif/native/users/delete |
删除 ONVIF 设备用户。 | 用户明确确认删除或清理后调用；调用前应先展示影响范围。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifDeleteUsersRequest |
POST /api/v2/onvif/native/users/set |
设置 ONVIF 设备用户。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifSetUserRequest |
POST /api/v2/onvif/native/video-sources |
查看ONVIF 视频输入源。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口<br>devices.control |
OnvifGetMediaSourcesRequest |
POST /api/v2/onvif/network-default-gateway/results |
回填 ONVIF 默认网关 默认网关结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifNetworkDefaultGatewayResultRequest |
POST /api/v2/onvif/network-interfaces/results |
回填 ONVIF 网卡配置 网络接口结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifNetworkInterfacesResultRequest |
POST /api/v2/onvif/network-protocols/results |
回填 ONVIF 网络协议和端口 网络协议结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifNetworkProtocolsResultRequest |
POST /api/v2/onvif/ntp/results |
回填 ONVIF NTP 时间服务器 配置结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifNtpResultRequest |
POST /api/v2/onvif/profiles/results |
回填 ONVIF 媒体配置档结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifProfilesResultRequest |
POST /api/v2/onvif/ptz |
创建 ONVIF 云台动作 命令。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>devices.control |
OnvifPtzRequest |
POST /api/v2/onvif/relay-outputs/results |
回填 ONVIF 继电器输出 继电器输出结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifRelayOutputsResultRequest |
POST /api/v2/onvif/scopes/results |
回填 ONVIF 设备作用域 发现范围结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifScopesResultRequest |
POST /api/v2/onvif/service-capabilities/results |
回填 ONVIF 服务能力 服务能力结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifServiceCapabilitiesResultRequest |
POST /api/v2/onvif/services/results |
回填 ONVIF 服务地址 服务列表结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifServicesResultRequest |
POST /api/v2/onvif/snapshot-uri/results |
回填 ONVIF 快照地址结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifSnapshotUriResultRequest |
GET /api/v2/onvif/state-model |
查看ONVIF 能力状态模型。 | 在展示功能、生成表单或发起控制前，先用它确认当前版本和目标设备真正支持什么。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口<br>devices.view |
无业务参数 |
POST /api/v2/onvif/stream-uri/results |
回填 ONVIF 视频流地址结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifStreamUriResultRequest |
POST /api/v2/onvif/system-date-time/results |
回填 ONVIF 系统日期时间 系统时间结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifSystemDateTimeResultRequest |
POST /api/v2/onvif/system-log/results |
回填 ONVIF 设备系统日志 系统日志结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifSystemLogResultRequest |
POST /api/v2/onvif/users/results |
回填 ONVIF 设备用户 用户列表结果。 | 这是组件之间自动通信的入口，第三方业务系统不要主动调用。 | 由调用方与服务端身份校验、回执和关联命令状态共同确认。 | 内部回调<br>devices.control |
OnvifUsersResultRequest |
统一对讲
| 接口 | 讲人话 | 什么时候用 | 调完看什么 | 身份 / 权限 | 主要输入 |
|---|---|---|---|---|---|
POST /api/v2/onvif/devices/{deviceId}/profiles/{channelId}/talk-capabilities/refresh |
刷新 ONVIF Profile 的音频输出与对讲解码能力。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>devices.manage |
deviceId（必填）、channelId（必填）、OnvifTalkCapabilitiesRefreshRequest |
POST /api/v2/onvif/talk/{sessionId}/stop |
停止 ONVIF Audio Backchannel 对讲。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>devices.talk |
sessionId（必填） |
POST /api/v2/onvif/talk/start |
启动 ONVIF RTSP Audio Backchannel 对讲。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口<br>devices.talk |
OnvifStartTalkRequest |
接口字段与示例
本页故意先讲清业务用途，不把几百个字段塞进说明文字。真正编码时，请使用与部署版本一起提供的 OpenAPI 和 Postman 资产查看请求体、响应体、枚举、文件类型与示例；不要拿网站最新契约调用旧版本服务。