# 再生セッションのエラーリファレンス

再生セッション API エラーを特定し、HTTP ステータスとリクエスト ID を理解し、安全な回復アクションを選択します。

再生が許可されるまでの流れ

視聴できるユーザーは、お客様のバックエンドが判断します。DRM-X は再生の認可情報を返し、プレーヤーはその情報を使って DRM ライセンスをリクエストします。

- 01**視聴者**

お客様のサービスにログインし、動画の再生をリクエストします。

- 02**お客様のバックエンド**

購入履歴、サブスクリプション、その他の視聴権限を確認します。

- 03**DRM-X**

選択した再生ルールを適用し、再生設定と認可情報を返します。

- 04**プレーヤー**

受け取った認可情報を使い、再生に必要な DRM ライセンスをリクエストします。

バックエンドはアクセスを決定します。DRM-Xは署名されたポリシーを強制します。暗号化されたメディアとDRMのライセンスは、別の配送パスに従います。

## 問題の response[#](#read-the-problem-response) を読んで下さい

再生セッションのエラーには、 HTTP ステータスプラス機械読み取り可能 `code`, `requestId`, `retryable`, と `contractVersion`. バリデーションの失敗もフィールドエラーを識別します。リクエストを録音する ID ログなしのステージが失敗しました 認証情報, DRM License Tokens, 課題, またはライセンスバイト.

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

これは、 illustrative error excerpt です。 実際の応答には、問題 `type`、`detail`、およびフィールド固有の `errors` を含めることができます。

## playback_authentication_required[#](#playback_authentication_required)

**HTTP 401.** プロジェクトAPI クライアントは、このリクエストのために欠落しているか、有効でない。

サーバー側の認証情報、環境、license-tokens:create 権限を確認してください。



## playback_session_invalid[#](#playback_session_invalid)

**HTTP 400.** 1つ以上のリクエストフィールドは検証に失敗します。

エラーを読んで、名前付きフィールドを修正し、公開されたパッケージにポリシーに一致させます。



## playback_environment_not_found[#](#playback_environment_not_found)

**HTTP 404.** 再生環境が見つかりません。

意図した環境 UUID を独自の 認証情報 で使用してください。



## playback_content_not_found[#](#playback_content_not_found)

**HTTP 404.** 公開されたパッケージおよび有効なキー セットはこの要求に一致しません。

信頼できるContent ID、環境、公開された状態、およびアクティブなキーセットを確認してください。



## playback_manifest_not_found[#](#playback_manifest_not_found)

**HTTP 404.** 必須登録マニフェストは利用できません。

公開された出力には、この DRM に必要なマニフェストタイプが含まれていることを確認してください。



## playback_blocked[#](#playback_blocked)

**HTTP 403.** アクティブ DRM-X ブラックリストのルールブロック再生。

該当するアクセスルールを確認します。 プレーヤー から再試行またはバイパスしないでください。



## concurrent_stream_limit_reached[#](#concurrent_stream_limit_reached)

**HTTP 403.** 同時ストリームの上限に達しました。

終了するか、または放棄されたセッションを解放し、あなたのアカウントアクセスポリシーを適用して下さい。



## playback_session_rate_limited[#](#playback_session_rate_limited)

**HTTP 429.** セッションエンドポイントレートの上限に達しました。

Retry-After を指定すると、重複したセッションリクエストを避け、バインドされたバックオフを使用します。



## プレーバックの失敗からAPI を分ける[#](#separate-api-failures-from-playback-failures)

成功したセッション応答は、メディア、コーデック、DRMデバイスサポート、または出力保護が準備されていることを証明しません。最初の失敗したステージを識別するために、[failure-stage matrix](https://docs.drm-x.com/ja/troubleshooting/playback)を使用します。

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