오류 참조

이것은 재생 API에서 반환한 오류에 대한 참조입니다.

상태 코드 및 오류

상태	오류 코드	설명
200	`SUCCESS`	정상적인 응답이 전송됩니다.
400	`BAD_REQUEST`	형식이 잘못된 요청, 즉 중복 쿼리 매개 변수가 제공됨
401	`INVALID_POLICY_KEY`	법적 정책 키와 함께 BCOV-Policy 헤더를 제공해야합니다.
403	`ACCESS_DENIED` , `VIDEO_NOT_PLAYABLE` , `PLAYLIST_NOT_PLAYABLE` , `JWT_AUTH`	제공된 정책 키가 이 계정이나 동영상을 허용하지 않거나 요청된 리소스가 비활성 상태입니다. `VIDEO_NOT_PLAYABLE`단일 비디오 요청으로 Roebuck에서 반환할 수 있습니다. 비디오가 재생 가능 확인 (수집 됨, 활성, 일정에 있음)을 통과하지 못했음을 나타냅니다.
404	`VIDEO_NOT_FOUND` , `PLAYLIST_NOT_FOUND` , `RESOURCE_NOT_FOUND` , `ACCOUNT_NOT_FOUND`	지정된 리소스를 찾을 수 없습니다.
405	`METHOD_NOT_ALLOWED`	이 API에는 GET, HEAD 및 OPTIONS 만 허용됩니다.
500	`SERVER_ERROR`	내부 웨지 서버 오류, 일반적으로 로그에 더 많은 정보가 있습니다.
502	`SERVER_ERROR` , `ACCOUNT_RETRIEVE_FAILUREVIDEO_RETRIEVE_FAILURE` , `VIDEO_URLS_RETRIEVE_FAILURE` , `PLAYLIST_RETRIEVE_FAILURE` , `PLAYLIST_VIDEOS_RETRIEVE_FAILURE`	백엔드 서버에서 잘못된 응답을 받았습니다. 일반적으로 Roebuck 또는 Nomic이 5xx 오류를 반환했습니다.
503	`SERVICE_UNAVAILABLE`	Wedge에서 반환하지 않습니다. Load Balancer에 활성 서버가없는 경우 발생할 수 있습니다. 그것은 나쁠 것입니다. (Playerback API는 속도 제한을 수행하지 않으며 호출하는 서비스도 수행하지 않습니다.)
504	`SERVER_TIMEOUT`	백엔드 서버 또는 그들이 의존하는 서버 중 하나에 대한 호출이 시간 초과되었습니다.

오류 응답

API 설계 표준에 따라 오류 응답( 4xx그리고5xx )는 다음을 포함하는 하나 이상의 맵의 오류 응답 목록으로 구성됩니다. error_code , 선택적error_subcode및 선택적으로 현지화되지 않은message자세한 내용과 함께.

[{"에러 코드": "ERROR_CODE1"},
  {"오류 코드”: "ERROR_CODE2", "message": "여기에서 세부 정보를 확인할 수 있습니다."}
  {"오류 코드”: "ERROR_CODE3", "error_subcode": "MORE_SPECIFIC_CODE", "message": "일어난 상황에 대해 사람이 읽을 수있는 세부 정보"}]

오류 코드

이는 사람이 이해할 수 있도록 하기 위한 것이며 클라이언트 코드에서 다른 작업과 번역 가능한 사용자 메시지를 선택하는 데 사용할 수 있도록 하기 위한 것입니다. error_code 오류 코드는 UPPER_SNAKE_CASE입니다.

상태	오류 코드	오류 소스
403	`ACCESS_DENIED`	노믹 정책
403	`VIDEO_NOT_PLAYABLE`	로벅
404	`VIDEO_NOT_FOUND`	로벅
기타	`VIDEO_RETRIEVE_FAILURE`비디오를 검색할 수 없는 경우	로벅
기타	`VIDEO_URLS_RETRIEVE_FAILURE`소스 또는 이미지를 검색할 수 없는 경우	로벅

오류 하위 코드

다음은 전부는 아니지만 일부 오류 하위 코드입니다 ( :error_subcode소스에서 검색).

오류 코드	오류 하위 코드
`BAD_REQUEST`	`DUPLICATE_PARAMETERS`
`ACCESS_DENIED`	`POLICY_ERROR`
`ACCESS_DENIED`	`ACCOUNT_ID` , `VIDEO_IDCLIENT_GEO` , `CLIENT_IP` , `DOMAIN` , `POLICY_ERROR`^[1]
`SOURCES_RESTRICTED`	`TVE_AUTH`
`SERVER_ERROR`	`LOOKUP_GEO`
`SERVER_TIMEOUT`	`LOOKUP_GEO`

참고

^[1]ACCESS_DENIED /은 정책을 평가하는 동안 발생한 예상치 못한 오류를POLICY_ERROR의미합니다 (지리적 제한 계정의 동영상 정보 가져오기 포함). 이 오류와 함께 로그에서 예외를 확인하는 것이 좋습니다.