Repository navigation
zh CN development local run
AKStream documentation edited this page Oct 7, 2026
·
1 revision
这一层回答“平台是否正常、节点是否在线、配置是否生效、日志去哪里查”。业务系统通常只读取状态；配置、进程和节点生命周期操作应留给管理员。
本页覆盖 168 个接口。每一行都回答五件事：接口地址、它做什么、何时调用、如何确认完成、谁可以调用。参数字段的精确定义以同版本 OpenAPI 为准。
“业务接口”可以由 WebUI 或第三方系统按权限调用；“管理员接口”需要后台管理员；“内部接口/内部回调”只允许产品组件之间使用。
| 接口 | 讲人话 | 什么时候用 | 调完看什么 | 身份 / 权限 | 主要输入 |
|---|---|---|---|---|---|
GET /api/v2/config/center |
查看配置中心快照。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.config.view
|
无业务参数 |
PUT /api/v2/config/center |
按白名单更新 JSON 配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.config.manage
|
AkConfigurationPatchRequest |
GET /api/v2/config/raw |
查看受控原始 JSON 配置文件。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.config.raw.manage
|
fileName |
PUT /api/v2/config/raw |
确认写入原始 JSON 配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.config.raw.manage
|
AkRawConfigurationApplyRequest |
POST /api/v2/config/raw/plan |
预览原始 JSON 配置差异。 | 准备执行变更前先调用，用来预览影响范围，确认无误后再调用真正执行接口。 | 返回的是计划或评估结果，不会自动执行真正变更。 | 管理员接口system.config.raw.manage
|
AkRawConfigurationPlanRequest |
GET /api/v2/config/runtime |
查看.NET Runtime / GC 配置。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.config.view
|
无业务参数 |
PUT /api/v2/config/runtime |
确认写入 .NET Runtime / GC 配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.config.manage
|
AkRuntimeConfigurationApplyRequest |
POST /api/v2/config/runtime/plan |
预览 .NET Runtime / GC 配置差异。 | 准备执行变更前先调用，用来预览影响范围，确认无误后再调用真正执行接口。 | 返回的是计划或评估结果，不会自动执行真正变更。 | 管理员接口system.config.manage
|
AkRuntimeConfigurationPlanRequest |
GET /api/v2/events/outbox |
查询 Outbox 事件。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.logs.view
|
page、pageSize |
GET /api/v2/events/runtime/info |
查询运行状态 WebSocket 协议说明。 | 在展示功能、生成表单或发起控制前，先用它确认当前版本和目标设备真正支持什么。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口authenticated
|
无业务参数 |
GET /api/v2/events/runtime/ws |
建立已认证的运行状态 WebSocket。 | 页面加载、刷新状态或按条件检索数据时调用。 | 连接升级为 WebSocket 只是开始；还要处理鉴权失败、断线重连和事件序号。 | 业务接口authenticated
|
无业务参数 |
GET /api/v2/setup/catalog |
查看首次配置选项。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填） |
POST /api/v2/setup/complete |
提交首次配置并查看结果。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填）、FirstRunInstallationRequest |
POST /api/v2/setup/database/test |
测试安装数据库连接。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填）、FirstRunDatabaseInput |
GET /api/v2/setup/detect/network |
检查安装网络环境。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填） |
POST /api/v2/setup/detect/nginx |
检查 HTTPS 代理环境。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填）、FirstRunEnvironmentDetectionRequest |
POST /api/v2/setup/files/browse |
浏览安装目录。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填）、FirstRunPathRequest |
POST /api/v2/setup/files/directories |
创建安装目录。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填）、FirstRunDirectoryCreateRequest |
GET /api/v2/setup/files/roots |
列出安装目录选择入口。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填） |
POST /api/v2/setup/files/validate |
验证安装目录。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填）、FirstRunPathRequest |
GET /api/v2/setup/media/build/inspect |
检查媒体服务准备条件。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 仅首次初始化setup-token
|
sourceMode、X-AK-Setup-Token（必填） |
POST /api/v2/setup/media/build/start |
启动媒体服务准备任务。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填）、FirstRunMediaBuildRequest |
GET /api/v2/setup/media/build/status |
查看媒体服务准备状态。 | 做页面概览、运行监控或排障时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 仅首次初始化专用流程
|
无业务参数 |
POST /api/v2/setup/notifications/test |
测试通知配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填）、FirstRunNotificationInput |
POST /api/v2/setup/preflight |
预检首次配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 仅首次初始化setup-token
|
X-AK-Setup-Token（必填）、FirstRunInstallationRequest |
GET /api/v2/setup/status |
查看安装状态。 | 做页面概览、运行监控或排障时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 公开入口专用流程
|
无业务参数 |
GET /api/v2/system/api-docs |
跳转到受登录保护的 Knife4j API 文档。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 诊断接口system.view
|
无业务参数 |
GET /api/v2/system/background-tasks |
查询当前进程后台任务注册结果。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
无业务参数 |
POST /api/v2/system/config/deploy |
部署配置版本。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.config.manage
|
SystemConfigDeployRequest |
GET /api/v2/system/config/effective |
查看带来源和生效方式的有效配置。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.config.view
|
scopeType、scopeId |
POST /api/v2/system/config/plan |
预览白名单配置差异和最高生效级别。 | 准备执行变更前先调用，用来预览影响范围，确认无误后再调用真正执行接口。 | 返回的是计划或评估结果，不会自动执行真正变更。 | 管理员接口system.config.manage
|
SystemConfigPlanRequest |
GET /api/v2/system/config/revisions |
查看配置版本历史。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.config.view
|
scopeType、scopeId、limit |
POST /api/v2/system/config/rollback |
回滚到历史配置版本。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.config.manage
|
SystemConfigRollbackRequest |
GET /api/v2/system/config/scopes |
列出配置作用域。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.config.view
|
无业务参数 |
POST /api/v2/system/config/wizard/apply |
确认后分组应用向导计划。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.config.manage
|
ConfigurationWizardApplyRequest |
GET /api/v2/system/config/wizard/assessment |
评估目标节点资源、媒体负载、流媒体配置可读性和端口环境。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.config.view
|
nodeId |
GET /api/v2/system/config/wizard/catalog |
查看AKStream.Next、流媒体服务与宿主机的完整向导参数目录。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.config.view
|
nodeId |
POST /api/v2/system/config/wizard/plan |
把选中的向导建议转换为 AKStream、流媒体服务、宿主和外部操作计划。 | 准备执行变更前先调用，用来预览影响范围，确认无误后再调用真正执行接口。 | 返回的是计划或评估结果，不会自动执行真正变更。 | 管理员接口system.config.manage
|
ConfigurationWizardPlanRequest |
POST /api/v2/system/config/wizard/recommend |
按业务峰值、延迟与弱网目标逐项生成配置建议。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.config.manage
|
ConfigurationWizardRecommendRequest |
GET /api/v2/system/console/summary |
查看系统中枢运行总览。 | 做页面概览、运行监控或排障时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
无业务参数 |
GET /api/v2/system/data-retention/cleanup/preview |
预览中间数据保留清理范围。 | 准备执行变更前先调用，用来预览影响范围，确认无误后再调用真正执行接口。 | 返回的是计划或评估结果，不会自动执行真正变更。 | 业务接口system.config.view
|
actor、reason |
POST /api/v2/system/data-retention/cleanup/run-once |
立即执行一轮中间数据保留清理。 | 用户明确确认删除或清理后调用；调用前应先展示影响范围。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
DataRetentionCleanupRunRequest |
GET /api/v2/system/database-schema-audit |
GET /api/v2/system/database-schema-audit。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
includeDdl、maxDdlChars |
POST /api/v2/system/filesystem/directories |
在当前服务器目录中创建并回读验证一个直接子目录。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.config.manage
|
SystemDirectoryCreateRequest |
GET /api/v2/system/filesystem/entries |
按配置字段语义浏览当前服务所在服务器的目录或文件。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.config.manage
|
fieldPath（必填）、path |
GET /api/v2/system/filesystem/roots |
列出当前服务所在服务器的文件系统选择入口。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.config.manage
|
fieldPath（必填） |
POST /api/v2/system/filesystem/validate |
校验手写服务器路径的存在性、类型、读取权限与可执行权限。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.config.manage
|
SystemPathValidationRequest |
GET /api/v2/system/info |
查看系统基础信息。 | 在展示功能、生成表单或发起控制前，先用它确认当前版本和目标设备真正支持什么。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
无业务参数 |
GET /api/v2/system/lifecycle/agents |
查看Node Agent 在线和版本状态。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.lifecycle.view
|
无业务参数 |
POST /api/v2/system/lifecycle/agents/{nodeId}/enrollment |
创建一次性 Node Agent 注册码。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.lifecycle.manage
|
nodeId（必填）、CreateNodeAgentEnrollmentRequest |
GET /api/v2/system/lifecycle/operations |
查看节点生命周期操作。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 管理员接口system.lifecycle.view
|
nodeId、limit |
POST /api/v2/system/lifecycle/operations |
创建受 Agent 执行的节点生命周期操作。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 管理员接口system.lifecycle.manage
|
CreateNodeLifecycleOperationRequest |
POST /api/v2/system/logs/agent/sessions |
围绕所选日志创建只读、多轮大语言模型智能诊断会话。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.logs.view
|
LogDiagnosticAgentStartRequest |
GET /api/v2/system/logs/agent/sessions/{id} |
查看日志智能诊断会话状态。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.logs.view
|
id（必填） |
POST /api/v2/system/logs/agent/sessions/{id}/cancel |
取消日志智能诊断当前轮次，不删除已经采集的会话证据。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.logs.view
|
id（必填） |
GET /api/v2/system/logs/agent/sessions/{id}/events |
增量读取日志智能诊断中的模型消息、工具参数、工具结果与最终结论。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.logs.view
|
id（必填）、after |
POST /api/v2/system/logs/agent/sessions/{id}/messages |
在已有日志智能诊断上下文中继续追问并允许模型追加只读查询。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.logs.view
|
id（必填）、LogDiagnosticAgentMessageRequest |
GET /api/v2/system/logs/analysis/status |
查看日志大语言模型分析能力状态，不返回 API Key。 | 做页面概览、运行监控或排障时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.logs.view
|
无业务参数 |
POST /api/v2/system/logs/analyze |
选择服务器环形缓冲中的日志，自动关联原始上下文并进行大语言模型故障分析。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.logs.view
|
LogAnalysisRequest |
GET /api/v2/system/logs/files/{fileId}/download |
下载白名单目录内的日志文件。 | 页面加载、刷新状态或按条件检索数据时调用。 | 检查 Content-Type、文件长度或 Range 响应，不要按普通 JSON 解析。 | 业务接口system.logs.download
|
fileId（必填） |
GET /api/v2/system/logs/query |
按来源、级别、关键字和 TraceId 查询系统日志。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.logs.view
|
Source（必填）、FileId、Level、Keyword、TraceId、From、To、TailLines |
GET /api/v2/system/logs/sources |
列出系统日志来源、集群节点、媒体服务和安全文件标识。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.logs.view
|
无业务参数 |
GET /api/v2/system/logs/stream |
以 NDJSON 长连接实时输出可断线续传的 日志。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.logs.view
|
after、sessionId、tail、nodeIds、mediaServerIds |
GET /api/v2/system/migration-audit |
执行 迁移数据体检。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
clusterId、includeSamples、sampleSize、includePassed |
POST /api/v2/system/migration-audit/removed-protocol-residues/cleanup |
清理已移除协议历史残留数据。 | 用户明确确认删除或清理后调用；调用前应先展示影响范围。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
RemovedProtocolResidueCleanupRequest |
POST /api/v2/system/notifications/email/test |
登录后台后测试系统 SMTP 运维通知配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.view
|
SystemEmailTestRequest |
GET /api/v2/system/openapi-audit |
审计 Swagger/Knife4j 接口文档质量。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 诊断接口system.view
|
onlyProblems |
GET /api/v2/system/parity-audit |
审计旧 AKStream 关键能力在 Next 中的覆盖关系。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
clusterId、checkDatabase、includeDetails、includePassed |
GET /api/v2/system/readiness |
执行系统验收检查。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
checkDatabase、checkZlm |
GET /api/v2/system/roles |
查看当前进程角色。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
无业务参数 |
GET /api/v2/system/runtime/diagnostics |
查看当前 运行环境诊断。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
无业务参数 |
GET /api/v2/system/runtime/ports |
按当前启用模块、实际配置和监听状态生成端口开放清单。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
无业务参数 |
GET /api/v2/system/runtime/tuning |
查看当前宿主机白名单调优参数与执行能力。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
无业务参数 |
PUT /api/v2/system/runtime/tuning |
通过 NodeAgent 与固定 root helper 应用并验证 Linux 宿主调优参数。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.host.manage
|
HostTuningApplyRequest |
POST /api/v2/system/runtime/tuning/plan |
预览 Linux 宿主句柄、IPv6 与 TCP 白名单参数差异。 | 准备执行变更前先调用，用来预览影响范围，确认无误后再调用真正执行接口。 | 返回的是计划或评估结果，不会自动执行真正变更。 | 业务接口system.host.manage
|
HostTuningPlanRequest |
GET /api/v2/system/source-documentation-audit |
审计服务端接口注释覆盖情况。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 诊断接口system.view
|
onlyProblems、checkParameterAndReturnTags、maxResults |
GET /api/v2/system/swagger |
跳转到受登录保护的 Swagger UI。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 诊断接口system.view
|
无业务参数 |
GET /api/v2/system/tasks |
查看内置后台任务注册和运行状态。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.tasks.view
|
无业务参数 |
POST /api/v2/system/tasks/{taskName}/run |
预览或人工执行受支持的内置任务。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口system.tasks.execute
|
taskName（必填）、RunSystemTaskRequest |
GET /api/v2/system/tls/acme |
查看内置 .NET ACME、Let's Encrypt 证书、待验证订单和自动续签状态。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.config.view
|
无业务参数 |
POST /api/v2/system/tls/acme/apply-nginx |
将已签发的正式 ACME 证书写入 Nginx 站点配置，校验成功后 Reload，失败自动恢复。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
无业务参数 |
PUT /api/v2/system/tls/acme/automation |
开启或关闭 每 12 小时的自动续签检查及 Nginx 自动 Reload。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
AcmeAutomationRequest |
POST /api/v2/system/tls/acme/complete |
检查已生成的 HTTP/DNS 验证内容，完成 ACME 验证、CSR 和证书下载。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
AcmeCompleteRequest |
POST /api/v2/system/tls/acme/issue |
使用 Let's Encrypt 测试或正式环境签发证书，并登记自动续签状态。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
AcmeCertificateRequest |
POST /api/v2/system/tls/acme/preflight |
在签发前检查公网域名、HTTP 验证目录或手工 DNS TXT 前置条件。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
AcmeCertificateRequest |
POST /api/v2/system/tls/acme/prepare |
由内置 .NET ACME 客户端创建订单并生成 HTTP 文件或 DNS TXT 验证内容。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
AcmeCertificateRequest |
POST /api/v2/system/tls/acme/renew |
执行指定证书的续签演练或真实续签。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
AcmeRenewRequest |
GET /api/v2/system/tls/deployment |
探测 Nginx、Kestrel、域名网络入口与 MediaServer 证书生效状态。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.config.view
|
无业务参数 |
POST /api/v2/system/tls/nginx/reload |
校验成功后审计并重新加载 Nginx。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
NginxReloadRequest |
POST /api/v2/system/tls/nginx/template |
生成不会自动落盘的 Nginx HTTPS/WSS 反向代理模板。 | 在展示功能、生成表单或发起控制前，先用它确认当前版本和目标设备真正支持什么。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
NginxTemplateRequest |
POST /api/v2/system/tls/nginx/validate |
使用已探测的可执行文件和配置路径执行 nginx -t。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
无业务参数 |
GET /api/v2/system/upgrades |
查看当前实例最近的正式包升级记录和持久化执行状态。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.upgrade.view
|
无业务参数 |
GET /api/v2/system/upgrades/{id} |
查看一个升级任务。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.upgrade.view
|
id（必填） |
POST /api/v2/system/upgrades/{id}/start |
二次确认后由本机高权限 NodeAgent 调度脱离主进程的升级事务。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口system.upgrade.manage
|
id（必填）、StartSystemUpgradeRequest |
POST /api/v2/system/upgrades/packages |
以流式请求体上传并预检当前平台正式升级包。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.upgrade.manage
|
无业务参数 |
GET /api/v2/system/version |
查看版本信息。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
无业务参数 |
GET /api/v2/system/webhooks/catalog |
查看第三方 Webhook 可选事件目录。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
无业务参数 |
POST /api/v2/system/webhooks/deliveries/{id}/retry |
重试指定方案的一条失败投递。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口system.config.manage
|
id（必填） |
POST /api/v2/system/webhooks/outbox/{id}/retry |
人工重试第三方 Webhook。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口system.config.manage
|
id（必填） |
GET /api/v2/system/webhooks/status |
查询第三方 Webhook 状态。 | 做页面概览、运行监控或排障时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
无业务参数 |
GET /api/v2/system/webhooks/subscriptions |
列出第三方 Webhook 推送方案。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
includeArchived |
POST /api/v2/system/webhooks/subscriptions |
创建一个地址对应的 Webhook 推送方案。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
OutboundWebhookSubscriptionRequest |
PUT /api/v2/system/webhooks/subscriptions/{id} |
修改 Webhook 推送方案。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
id（必填）、OutboundWebhookSubscriptionRequest |
POST /api/v2/system/webhooks/subscriptions/{id}/archive |
归档 Webhook 推送方案并保留历史。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
id（必填） |
GET /api/v2/system/webhooks/subscriptions/{id}/deliveries |
分页读取指定方案的独立投递历史。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.view
|
id（必填）、page、pageSize |
POST /api/v2/system/webhooks/subscriptions/{id}/test |
向指定 Webhook 推送方案发送真实测试事件。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
id（必填）、OutboundWebhookTestRequest |
POST /api/v2/system/webhooks/test |
发送第三方 Webhook 测试事件。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
OutboundWebhookTestRequest |
POST /api/v2/system/zlm-configuration/apply |
确认完整预览集合后向原目标节点下发配置写入。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.manage
|
MediaServiceConfigurationApplyRequest |
GET /api/v2/system/zlm-configuration/operations/{id} |
查看目标媒体配置任务的真实状态和脱敏回读结果。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
id（必填） |
POST /api/v2/system/zlm-configuration/plan |
逐节点预览媒体配置差异，不写入文件。 | 准备执行变更前先调用，用来预览影响范围，确认无误后再调用真正执行接口。 | 返回的是计划或评估结果，不会自动执行真正变更。 | 业务接口system.config.manage
|
MediaServiceConfigurationPlanRequest |
POST /api/v2/system/zlm-configuration/read |
按顶部管理上下文读取目标媒体节点的真实配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.view
|
MediaServiceConfigurationContext |
GET /health |
查看健康状态。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 公开入口*
|
无业务参数 |
| 接口 | 讲人话 | 什么时候用 | 调完看什么 | 身份 / 权限 | 主要输入 |
|---|---|---|---|---|---|
GET /api/v2/logging/level |
查看当前日志级别配置。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.logs.view
|
无业务参数 |
PUT /api/v2/logging/level |
设置全局日志级别。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.logs.manage
|
GlobalLogLevelRequest |
POST /api/v2/logging/overrides |
设置模块、节点、设备、流或接口的日志级别覆盖。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.logs.manage
|
LogLevelOverrideRequest |
DELETE /api/v2/logging/overrides/{scope}/{key} |
删除日志级别覆盖规则。 | 用户明确确认删除或清理后调用；调用前应先展示影响范围。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.logs.manage
|
scope（必填）、key（必填） |
PUT /api/v2/logging/zlm-module-output |
设置 内部流媒体服务模块常规日志开关。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.logs.manage
|
MediaServiceModuleOutputLogRequest |
PUT /api/v2/logging/zlm-process-output |
设置流媒体服务子进程输出日志开关。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.logs.manage
|
MediaServiceProcessOutputLogRequest |
| 接口 | 讲人话 | 什么时候用 | 调完看什么 | 身份 / 权限 | 主要输入 |
|---|---|---|---|---|---|
GET /api/v2/cluster/monitoring |
查询全局监控快照。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
clusterId、historyMinutes、historyNodeId、historyStart、historyEnd、historyBucketSeconds |
GET /api/v2/cluster/monitoring/current |
查询不含历史趋势的当前监控快照。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
clusterId |
GET /api/v2/cluster/monitoring/local-runtime |
查询当前节点最新的轻量进程资源快照。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
无业务参数 |
GET /api/v2/cluster/status |
查询集群运行状态。 | 做页面概览、运行监控或排障时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
clusterId |
GET /api/v2/media-servers |
查询流媒体服务节点列表。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
clusterId |
GET /api/v2/media-servers/{mediaServerId}/references |
查询流媒体服务节点退役前的业务引用明细。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
mediaServerId（必填）、clusterId、sampleSize |
POST /api/v2/media-servers/{mediaServerId}/retire |
预览或退役流媒体服务节点。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
mediaServerId（必填）、clusterId、RetireMediaServerRequest |
GET /api/v2/node/commands |
分页查询当前集群的 node 命令。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
page、pageSize、nodeId、zlmNodeId、status、commandType、requestedBy、localOnly、from、to、sinceHours、keyword |
GET /api/v2/node/commands/{commandId} |
查看node 命令详情。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
commandId（必填） |
GET /api/v2/node/commands/{commandId}/detail |
查看node 命令详情。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
commandId（必填） |
GET /api/v2/node/commands/local |
查询当前 node 的本机命令。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
status |
GET /api/v2/node/commands/stats |
统计当前集群的 node 命令状态。 | 做页面概览、运行监控或排障时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
nodeId、zlmNodeId、status、commandType、requestedBy、localOnly、from、to、sinceHours、keyword |
GET /api/v2/node/ffmpeg-templates |
查询 FFmpeg 模板列表。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
mediaServerId |
POST /api/v2/node/ffmpeg-templates |
新增 FFmpeg 模板。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
SaveFfmpegTemplateRequest |
DELETE /api/v2/node/ffmpeg-templates/{templateName} |
删除 FFmpeg 模板。 | 用户明确确认删除或清理后调用；调用前应先展示影响范围。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
templateName（必填）、mediaServerId |
PUT /api/v2/node/ffmpeg-templates/{templateName} |
修改 FFmpeg 模板。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
templateName（必填）、SaveFfmpegTemplateRequest |
GET /api/v2/node/rtp/leases |
查询 RTP 端口租约。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
status、direction |
POST /api/v2/node/rtp/leases |
申请 RTP 端口租约。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
RtpPortLeaseRequest |
POST /api/v2/node/rtp/leases/{leaseId}/release |
释放 RTP 端口租约。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
leaseId（必填）、RtpPortReleaseRequest |
POST /api/v2/node/rtp/ports/{port}/release |
按端口释放 RTP 端口租约。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
port（必填）、direction、RtpPortReleaseRequest |
GET /api/v2/node/zlm/config |
查看本机流媒体服务config.ini。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
无业务参数 |
POST /api/v2/node/zlm/config/apply |
应用本机流媒体服务config.ini 写入计划。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
无业务参数 |
POST /api/v2/node/zlm/config/plan |
生成本机流媒体服务config.ini 写入计划。 | 准备执行变更前先调用，用来预览影响范围，确认无误后再调用真正执行接口。 | 返回的是计划或评估结果，不会自动执行真正变更。 | 业务接口nodes.manage
|
无业务参数 |
GET /api/v2/node/zlm/config/raw |
查看原始 MediaServer config.ini。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.config.raw.manage
|
无业务参数 |
PUT /api/v2/node/zlm/config/raw |
备份并写入原始 MediaServer config.ini。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口system.config.raw.manage
|
MediaServiceRawConfigurationApplyRequest |
POST /api/v2/node/zlm/config/raw/plan |
校验并预览原始 MediaServer config.ini 差异。 | 准备执行变更前先调用，用来预览影响范围，确认无误后再调用真正执行接口。 | 返回的是计划或评估结果，不会自动执行真正变更。 | 业务接口system.config.raw.manage
|
MediaServiceRawConfigurationPlanRequest |
GET /api/v2/node/zlm/core-settings |
查看流媒体服务核心协议、延迟、端口和 HTTP 页面配置。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
无业务参数 |
PUT /api/v2/node/zlm/core-settings |
校验、备份并写入流媒体服务核心配置。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
SaveMediaServiceCoreSettingsRequest |
GET /api/v2/node/zlm/process |
查看本机流媒体服务进程状态。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
无业务参数 |
POST /api/v2/node/zlm/process/reload |
向本机流媒体服务进程发送热加载信号。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
无业务参数 |
POST /api/v2/node/zlm/process/restart |
重启本机流媒体服务进程。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
无业务参数 |
POST /api/v2/node/zlm/process/start |
启动本机流媒体服务进程。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口nodes.manage
|
无业务参数 |
POST /api/v2/node/zlm/process/stop |
停止本机流媒体服务进程。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口nodes.manage
|
无业务参数 |
GET /api/v2/nodes |
查询 节点列表。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
clusterId |
POST /api/v2/nodes/{nodeId}/commands |
创建 node 命令。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口nodes.manage
|
nodeId（必填）、clusterId、CreateNodeCommandRequest |
POST /api/v2/nodes/self/heartbeat |
手动触发当前进程 node 心跳。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口nodes.manage
|
firstPost |
| 接口 | 讲人话 | 什么时候用 | 调完看什么 | 身份 / 权限 | 主要输入 |
|---|---|---|---|---|---|
GET /api/v2/zlm/nodes |
查看已配置的流媒体服务节点。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
无业务参数 |
GET /api/v2/zlm/nodes/{nodeId}/apis |
查看指定流媒体服务节点 API 列表。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
nodeId（必填） |
GET /api/v2/zlm/nodes/{nodeId}/capabilities |
执行指定流媒体服务节点能力发现。 | 在展示功能、生成表单或发起控制前，先用它确认当前版本和目标设备真正支持什么。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
nodeId（必填） |
GET /api/v2/zlm/nodes/{nodeId}/recording-status |
查询指定流媒体服务节点上某路流的实际录像状态。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
nodeId（必填）、vhost、app、stream、type |
GET /api/v2/zlm/nodes/{nodeId}/version |
查看指定流媒体服务节点版本。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口nodes.view
|
nodeId（必填） |
GET /api/v2/zlm/webhook-inbox |
查询流媒体服务 WebHook 收件箱。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口system.logs.view
|
page、pageSize、hookName、mediaServerId、status、businessStatus |
| 接口 | 讲人话 | 什么时候用 | 调完看什么 | 身份 / 权限 | 主要输入 |
|---|---|---|---|---|---|
GET /api/v2/display-wall/programs |
查询显示墙节目。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口display-wall.view
|
无业务参数 |
POST /api/v2/display-wall/programs |
创建显示墙节目。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口display-wall.manage
|
SaveDisplayWallProgramRequest |
DELETE /api/v2/display-wall/programs/{id} |
删除未在播出的显示墙节目。 | 用户明确确认删除或清理后调用；调用前应先展示影响范围。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口display-wall.manage
|
id（必填） |
GET /api/v2/display-wall/programs/{id} |
查看一个显示墙节目。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口display-wall.view
|
id（必填） |
PUT /api/v2/display-wall/programs/{id} |
保存显示墙节目，并通过修订号防止并发覆盖。 | 用户提交业务动作或配置变更时调用。 | 重新读取目标资源，确认保存值和运行状态都已更新。 | 业务接口display-wall.manage
|
id（必填）、SaveDisplayWallProgramRequest |
GET /api/v2/display-wall/runtime |
查看显示墙播出控制与轻量通道在线快照。 | 页面加载、刷新状态或按条件检索数据时调用。 | 以返回数据、分页总数和目标资源的当前状态为准。 | 业务接口display-wall.view
|
无业务参数 |
POST /api/v2/display-wall/runtime/start |
从第一个场景启动节目轮询，所有已打开大屏按同一服务端时间同步播出。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口display-wall.manage
|
StartDisplayWallProgramRequest |
POST /api/v2/display-wall/runtime/stop |
停止节目轮询并冻结在当前场景，不清空已经上墙的画面。 | 用户提交业务动作或配置变更时调用。 | HTTP 成功只表示请求被接收；继续查询命令、任务、通道或会话状态，直到成功或失败终态。 | 业务接口display-wall.manage
|
无业务参数 |
本页故意先讲清业务用途，不把几百个字段塞进说明文字。真正编码时，请使用与部署版本一起提供的 OpenAPI 和 Postman 资产查看请求体、响应体、枚举、文件类型与示例；不要拿网站最新契约调用旧版本服务。