# Referensi kesalahan sesi pemutaran

Mengidentifikasi sesi pemutaran API error, memahami HTTP status dan ID permintaan, dan memilih tindakan pemulihan yang aman.

Cara pemutaran diotorisasi

Backend Anda menentukan siapa yang boleh menonton. DRM-X memberikan otorisasi pemutaran. Pemutar menggunakannya untuk meminta lisensi DRM.

- 01**Penonton**

Masuk ke layanan Anda dan meminta video.

- 02**Backend Anda**

Memeriksa pembelian, langganan, atau izin menonton lainnya milik pengguna.

- 03**DRM-X**

Menerapkan aturan yang dipilih dan mengembalikan konfigurasi serta otorisasi pemutaran.

- 04**Pemutar**

Menggunakan otorisasi yang diterima untuk meminta lisensi DRM yang diperlukan untuk pemutaran.

Backend Anda memutuskan akses; DRM-X memaksa kebijakan yang ditandatangani. Media tersandi dan DRM lisensi mengikuti jalur pengiriman terpisah.

## Baca respon masalah [ # ](#read-the-problem-response)

Galat sesi putar termasuk HTTP status ditambah mesin yang dapat dibaca `code`, `requestId`, `retryable`, dan `contractVersion`. Validasi kegagalan juga mengidentifikasi kesalahan field. Rekam permintaan ID dan gagal tahap tanpa log kredensial, DRM License Tokens s, tantangan, atau license bytes.

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

Ini adalah excerpt kesalahan ilustratif. Respon aktual dapat memuat masalah `type`, `detail`, dan lapangan-spesifik `errors`.

## playback_authentication_required[#](#playback_authentication_required)

** HTTP 401. ** Proyek API klien hilang atau tidak valid untuk permintaan ini.

Periksa kredensial di server, lingkungan yang dipilih, dan izin license-tokens:create.



## playback_session_invalid[#](#playback_session_invalid)

** HTTP 400. ** Satu atau lebih bidang permintaan gagal validasi.

Read errors, fix the named fields, and match the policy to the published package.



## playback_environment_not_found[#](#playback_environment_not_found)

** HTTP 404. ** Lingkungan putar tidak dapat ditemukan.

Gunakan lingkungan yang dimaksudkan UUID dengan sendiri kredensial.



## playback_content_not_found[#](#playback_content_not_found)

** HTTP 404. ** Tidak ada paket yang diterbitkan dan set kunci aktif yang cocok dengan permintaan ini.

Periksa yang terpercaya Content ID, lingkungan, keadaan diterbitkan, dan set kunci aktif.



## playback_manifest_not_found[#](#playback_manifest_not_found)

** HTTP 404. ** Daftar muatan yang dibutuhkan tidak tersedia.

Verifikasi bahwa keluaran yang diterbitkan berisi tipe manifest yang diperlukan untuk DRM ini.



## playback_blocked[#](#playback_blocked)

** HTTP 403. ** Sebuah aktif DRM-X aturan hitam blok memutar.

Tinjau aturan akses yang bisa diterapkan. Jangan coba atau bypass dari pemutar.



## concurrent_stream_limit_reached[#](#concurrent_stream_limit_reached)

** HTTP 403. ** Batas arus telah dicapai.

Rilis selesai atau sesi ditinggalkan dan menerapkan kebijakan akses akun Anda.



## playback_session_rate_limited[#](#playback_session_rate_limited)

** HTTP 429. ** Batas kecepatan sesi mencapai.

Menghormati Ulang Setelah ketika diberikan. Hindari permintaan duplikasi sesi dan gunakan baunded backoff.



## Pisahkan API kegagalan dari kegagalan putar [ # ](#separate-api-failures-from-playback-failures)

Respon sesi yang sukses tidak membuktikan bahwa media, codecs, dukungan perangkat DRM, atau perlindungan keluaran siap. Gunakan [falure- tahap matrix](https://docs.drm-x.com/id/troubleshooting/playback) untuk mengidentifikasi tahap gagal pertama.

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