# 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 资产查看请求体、响应体、枚举、文件类型与示例；不要拿网站最新契约调用旧版本服务。