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.
Lire la réponse au problème#
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#
HTTP 401. Le projet API client est manquant ou non valide pour cette demande.
Vérifiez le côté serveur identifiants, l'environnement et les jetons de licence:create scope.
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#
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#
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#
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#
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#
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#
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 #
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 pour identifier la première étape échouée.
DRM-X 6.0