# 재생 세션 오류 참조

재생 세션을 식별 API 오류, 이해 HTTP 상태 및 요청 ID, 그리고 안전한 복구 작업을 선택합니다.

재생이 승인되는 과정

백엔드가 시청 가능한 사용자를 결정합니다. DRM-X는 재생 승인 정보를 제공하며, 플레이어는 이를 사용해 DRM 라이선스를 요청합니다.

- 01**시청자**

서비스에 로그인하고 동영상 재생을 요청합니다.

- 02**고객 백엔드**

사용자의 구매 내역, 구독 상태 또는 기타 시청 권한을 확인합니다.

- 03**DRM-X**

선택한 재생 규칙을 적용하고 재생 설정과 승인 정보를 반환합니다.

- 04**플레이어**

반환된 승인 정보를 사용해 재생에 필요한 DRM 라이선스를 요청합니다.

귀하의 백엔드가 접근을 결정합니다. DRM-X는 서명 된 정책을 시행합니다. 암호화 된 미디어 및 DRM 라이센스는 별도의 배송 경로를 따릅니다.

## 문제 응답을 읽으십시오[#](#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
}
```

이것은 설명 오류 발췌입니다. 실제 응답은 문제 `type`, `detail` 및 필드 별 `errors`을 포함 할 수 있습니다.

## playback_authentication_required[#](#playback_authentication_required)

**HTTP 401.** 프로젝트 API 클라이언트가 이 요청에 대해 오류 또는 유효하지 않습니다.

서버의 인증 정보, 선택한 환경, license-tokens:create 권한을 확인하세요.



## playback_session_invalid[#](#playback_session_invalid)

**HTTP 400.** 하나 이상의 요청 필드가 유효하지 않습니다.

오류를 읽고, 이름 필드를 수정하고, 게시 된 패키지에 정책을 일치.



## 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.** 동시-stream limit가 도달했습니다.

완료 또는 버려진 세션을 해제하고 계정 액세스 정책을 적용하십시오.



## playback_session_rate_limited[#](#playback_session_rate_limited)

**HTTP 429.** 세션 엔드포인트 비율 제한이 도달되었습니다.

Respect Retry-After when provided. 중복 세션 요청을 피하고 바인딩 된 백오프를 사용하십시오.



## API 재생 실패에서 실패 [#](#separate-api-failures-from-playback-failures)

성공적인 세션 응답은 미디어, 코덱, DRM 장치 지원 또는 출력 보호가 준비되어 있음을 증명하지 않습니다. 첫 번째 실패 단계를 확인하려면 [failure-stage matrix](https://docs.drm-x.com/ko/troubleshooting/playback)를 사용하십시오.

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