# Fehlerreferenz für Wiedergabesitzungen

Identifizieren Sie die Playback Session API Fehler, verstehen HTTP Status und Anforderungs-IDs, und wählen Sie eine sichere Wiederherstellungsaktion.

So wird die Wiedergabe autorisiert

Ihr Backend entscheidet, wer Inhalte ansehen darf. DRM-X stellt die Wiedergabeautorisierung bereit. Damit fordert der Player eine DRM-Lizenz an.

- 01**Zuschauer**

Meldet sich bei Ihrem Dienst an und fordert ein Video an.

- 02**Ihr Backend**

Prüft den Kauf, das Abonnement oder eine andere Zugriffsberechtigung des Nutzers.

- 03**DRM-X**

Wendet die gewählten Wiedergaberegeln an und gibt Konfiguration und Autorisierung zurück.

- 04**Player**

Fordert mit der erhaltenen Autorisierung die für die Wiedergabe benötigte DRM-Lizenz an.

Ihr Backend entscheidet über den Zugriff; DRM-X erzwingt die unterschriebene Richtlinie. Verschlüsselte Medien und DRM Lizenzen folgen getrennten Lieferwegen.

## Lesen Sie die Problemantwort[#](#read-the-problem-response)

Zu den Playback-Session-Fehlern gehören HTTP Status plus maschinenlesbar `code`, `requestId`, `retryable`, und `contractVersion`Validierungsfehler erkennen auch Feldfehler. Anfrage aufzeichnen ID und gescheiterte Bühne ohne Protokollierung Zugangsdaten, DRM License Tokens, Challenges oder Lizenzbytes.

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

Tatsächliche Antworten können ein Problem `type`, `detail` und feldspezifisch `errors` enthalten.

## playback_authentication_required[#](#playback_authentication_required)

**HTTP 401.** Der Client des Projekts API fehlt oder ist für diese Anforderung nicht gültig.

Prüfen Sie die Zugangsdaten auf dem Server, die Umgebung und die Berechtigung license-tokens:create.



## playback_session_invalid[#](#playback_session_invalid)

**HTTP 400.** Ein oder mehrere Anforderungsfelder fehlschlagen.

Lesen Sie Fehler, beheben Sie die benannten Felder und passen Sie die Richtlinie dem veröffentlichten Paket an.



## playback_environment_not_found[#](#playback_environment_not_found)

**HTTP 404.** Die Wiedergabeumgebung konnte nicht gefunden werden.

Verwenden Sie die beabsichtigte Umgebung UUID mit ihrer eigenen Zugangsdaten.



## playback_content_not_found[#](#playback_content_not_found)

**HTTP 404.** Kein veröffentlichtes Paket und aktiver Schlüsselsatz entsprechen dieser Anforderung.

Überprüfen Sie den vertrauenswürdigen Content ID, die Umgebung, den veröffentlichten Status und den aktiven Schlüsselsatz.



## playback_manifest_not_found[#](#playback_manifest_not_found)

**HTTP 404.** Das erforderliche registrierte Manifest ist nicht verfügbar.

Stellen Sie sicher, dass die veröffentlichte Ausgabe den dafür erforderlichen Manifesttyp enthält DRM.



## playback_blocked[#](#playback_blocked)

**HTTP 403.** Eine aktive DRM-X Blacklist-Regel blockiert die Wiedergabe.

Überprüfen Sie die anwendbare Zugriffsregel. Versuchen Sie es nicht erneut oder umgehen Sie es nicht von der Player.



## concurrent_stream_limit_reached[#](#concurrent_stream_limit_reached)

**HTTP 403.** Die Concurrent-Stream-Grenze wurde erreicht.

Veröffentlichen Sie abgeschlossene oder abgebrochene Sitzungen und wenden Sie Ihre Kontozugriffsrichtlinie an.



## playback_session_rate_limited[#](#playback_session_rate_limited)

**HTTP 429.** Das Limit der Session-Endpunkt-Rate wurde erreicht.

Respect Retry-After, wenn vorgesehen. Vermeiden Sie doppelte Sitzungsanfragen und verwenden Sie ein begrenztes Backoff.



## Getrennte API Fehler von Wiedergabefehlern[#](#separate-api-failures-from-playback-failures)

Eine erfolgreiche Sitzung Antwort beweist nicht, dass Medien, Codecs, DRM Geräteunterstützung oder Ausgabeschutz sind bereit. [Fehlerstufenmatrix](https://docs.drm-x.com/de/troubleshooting/playback) um die erste gescheiterte Phase zu identifizieren.

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