播放会话错误参考

识别回放会话API 错误, 理解HTTP 状态并请求 ID, 并选择安全恢复动作。

查看 Markdown 现场实例更新2026-09-05

您的后端决定访问; DRM-X 执行已签名的政策。加密的媒体和DRM 许可证会遵循不同的传送路径。

读取问题响应#

播放会话错误包括: HTTP 状态加机器可读 code, requestId, retryable,以及 contractVersion。验证失败也会识别字段错误。记录请求 ID 且没有记录的阶段已失败凭据, DRM License Tokens,挑战或许可字节.

{
  "status": 400,
  "code": "playback_session_invalid",
  "title": "The playback session request is invalid.",
  "requestId": "your-request-correlation-id",
  "retryable": false,
  "contractVersion": 1
}

这是一个示例性错误节选。实际的响应可以包括一个问题type,detail, 以及针对字段的errors 。

playback_authentication_required#

HTTP 401. 项目 API 此请求缺少客户端或无效。

请检查date=中的日期值 (帮助) 服务器侧凭据, 环境, 和许可证托肯: 创建范围。

playback_session_invalid#

HTTP 400. 一个或多个请求字段失败验证。

读取错误,修正命名字段,并将策略与已发布的加密输出包匹配.

playback_environment_not_found#

HTTP 404. 的回放环境无法找到.

使用预定环境UUID与自己的凭据.

playback_content_not_found#

HTTP 404. 没有公布的加密输出包和活动的密钥集符合此请求。

请检查access-date=中的日期值 (帮助) 信任的Content ID,环境,发布状态,以及活动密钥集.

playback_manifest_not_found#

HTTP 404. 所要求的登记清单是没有的。

验证已公布的输出是否包含此 DRM 所需的显示类型。

playback_blocked#

HTTP 403. 活动 DRM-X 黑名单规则块回放。

审查适用的访问规则。不要重试或绕过播放器。

concurrent_stream_limit_reached#

HTTP 403. 双流极限已经达到

释放已完成或放弃的会话并应用您的账户访问策略。

playback_session_rate_limited#

HTTP 429. 达到了会话终点率限制.

提供后尊重重试。避免重复会话请求, 并使用限定的后退。