DRM-X 6.0 paloma y rama de olivo logotipoDRM-X 6.0Documentación
◎ Español

Referencia de errores de sesión de reproducción

Identificar los errores de sesión de reproducción API, entender HTTP estado y solicitar IDs, y elegir una acción de recuperación segura.

Ver MarkdownEjemplos en funcionamientoActualizado 2026-09-05
Su backend decide el acceso; DRM-X aplica la política firmada. Los medios cifrados y las licencias DRM siguen caminos de entrega separados.
Su backend decide el acceso; DRM-X aplica la política firmada. Los medios cifrados y las licencias DRM siguen caminos de entrega separados.

Lea la respuesta del problema#

Los errores de sesión de reproducción incluyen un estado HTTP más legible por máquina code, requestId, retryable, y contractVersion. Los fallos de validación también identifican errores de campo. Grabar la solicitud ID y la etapa fallida sin registro credenciales, DRM License Tokens, retos o bytes de licencia.

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

Este es un fragmento de error ilustrativo. Las respuestas reales pueden incluir un problema type, detail y sobre el terreno errors.

playback_authentication_required#

HTTP 401. El proyecto API cliente falta o no es válido para esta solicitud.

Revise el lado del servidor credenciales, medio ambiente y fichas de licencia:crear alcance.

playback_session_invalid#

HTTP 400. Uno o más campos de solicitud fallan la validación.

Lea errores, corrija los campos nombrados, y coincida con la política al paquete publicado.

playback_environment_not_found#

HTTP 404. El entorno de reproducción no se pudo encontrar.

Utilice el ambiente previsto UUID con su propio credenciales.

playback_content_not_found#

HTTP 404. Ningún paquete publicado y conjunto de clave activo coinciden con esta solicitud.

Compruebe la confianza Content ID, medio ambiente, estado publicado, y conjunto de clave activo.

playback_manifest_not_found#

HTTP 404. El manifiesto registrado requerido no está disponible.

Verifique que la salida publicada contiene el tipo de manifiesto requerido para este DRM.

playback_blocked#

HTTP 403. Una regla activa DRM-X bloquea la reproducción.

Revise la regla de acceso aplicable. No vuelva a entrar o eludirlo de la reproductor.

concurrent_stream_limit_reached#

HTTP 403. Se ha alcanzado el límite de corriente concurrente.

Liberar sesiones terminadas o abandonadas y aplicar su política de acceso a la cuenta.

playback_session_rate_limited#

HTTP 429. Se alcanzó el límite de la tasa final del período de sesiones.

Respetar Retry-After cuando se proporciona. Evite duplicar las solicitudes de sesión y utilizar el backoff consolidado.

Separar API fallas de reproducción #

Una respuesta exitosa de la sesión no prueba que los medios de comunicación, los codecs, DRM soporte de dispositivo, o protección de salida están listos. matriz de fase de falla para identificar la primera etapa fallida.