# Référence des erreurs de session de lecture

Identifier les erreurs de lecture API, comprendre le statut HTTP et demander des ID, et choisir une action de récupération sûre.

Comment la lecture est autorisée

Votre backend décide qui peut regarder le contenu. DRM-X fournit l’autorisation de lecture. Le lecteur l’utilise pour demander une licence DRM.

- 01**Spectateur**

Se connecte à votre service et demande une vidéo.

- 02**Votre backend**

Vérifie l’achat, l’abonnement ou toute autre autorisation d’accès de l’utilisateur.

- 03**DRM-X**

Applique les règles choisies et renvoie la configuration ainsi que l’autorisation de lecture.

- 04**Lecteur**

Utilise l’autorisation reçue pour demander la licence DRM nécessaire à la lecture.

Votre moteur décide de l'accès; DRM-X applique la politique signée. Les licences de médias chiffrés et DRM suivent des chemins de livraison séparés.

## Lire la réponse au problème[#](#read-the-problem-response)

Les erreurs de session de lecture comprennent un statut HTTP plus lisible par machine `code`, `requestId`, `retryable` et `contractVersion`. Les erreurs de validation identifient également les erreurs de champ. Enregistrez la requête ID et l'étape échouée sans enregistrer identifiants, DRM License Tokens, challenges ou octets de licence.

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

Il s'agit d'un extrait d'erreur illustratif. Les réponses réelles peuvent inclure un problème `type`, `detail` et un champ spécifique `errors`.

## playback_authentication_required[#](#playback_authentication_required)

**HTTP 401.** Le projet API client est manquant ou non valide pour cette demande.

Vérifiez les identifiants côté serveur, l’environnement et l’autorisation license-tokens:create.



## playback_session_invalid[#](#playback_session_invalid)

**HTTP 400.** Un ou plusieurs champs de requête échouent la validation.

Lisez les erreurs, corrigez les champs nommés et joignez la politique au paquet publié.



## playback_environment_not_found[#](#playback_environment_not_found)

**HTTP 404.** L'environnement de lecture n'a pas pu être trouvé.

Utiliser l'environnement prévu UUID avec son propre identifiants.



## playback_content_not_found[#](#playback_content_not_found)

**HTTP 404.** Aucun paquet publié et ensemble de clés active ne correspondent à cette requête.

Vérifiez l'ensemble de clés de confiance Content ID, environnement, état publié et actif.



## playback_manifest_not_found[#](#playback_manifest_not_found)

**HTTP 404.** Le manifeste enregistré requis n'est pas disponible.

Vérifiez que la sortie publiée contient le type de manifeste requis pour ce DRM.



## playback_blocked[#](#playback_blocked)

**HTTP 403.** Une règle active DRM-X de la liste noire bloque la lecture.

Passez en revue la règle d'accès applicable. Ne pas réessayer ou contourner le lecteur.



## concurrent_stream_limit_reached[#](#concurrent_stream_limit_reached)

**HTTP 403.** La limite de débit concurrent a été atteinte.

Relâchez les séances terminées ou abandonnées et appliquez votre politique d'accès à votre compte.



## playback_session_rate_limited[#](#playback_session_rate_limited)

**HTTP 429.** La limite de taux de fin de session a été atteinte.

Respectez Reessayer-Après quand fourni. Évitez les demandes de session dupliquées et l'utilisation limitée de backoff.



## Séparer API des pannes de lecture [#](#separate-api-failures-from-playback-failures)

Une réponse de session réussie ne prouve pas que les supports, les codecs, le support du périphérique DRM ou la protection de sortie sont prêts. Utilisez la matrice [ de stade d'échec ](https://docs.drm-x.com/fr/troubleshooting/playback) pour identifier la première étape échouée.

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