# 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.

Cómo se autoriza la reproducción

Su backend decide quién puede ver el contenido. DRM-X proporciona la autorización de reproducción. El reproductor la utiliza para solicitar una licencia DRM.

- 01**Espectador**

Inicia sesión en su servicio y solicita un vídeo.

- 02**Su backend**

Comprueba la compra, la suscripción u otro permiso del usuario para ver el contenido.

- 03**DRM-X**

Aplica las reglas seleccionadas y devuelve la configuración y la autorización de reproducción.

- 04**Reproductor**

Utiliza la autorización recibida para solicitar la licencia DRM necesaria para reproducir el contenido.

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[#](#read-the-problem-response)

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[#](#playback_authentication_required)

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

Compruebe las credenciales del servidor, el entorno y el permiso license-tokens:create.



## playback_session_invalid[#](#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[#](#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[#](#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[#](#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[#](#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[#](#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[#](#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 [#](#separate-api-failures-from-playback-failures)

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](https://docs.drm-x.com/es/troubleshooting/playback) para identificar la primera etapa fallida.

<!-- Canonical: https://docs.drm-x.com/es/api-reference/errors -->
<!-- Language: es -->