지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    오류 참조

    이것은 재생 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_FAILURE , VIDEO_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 설계 표준에 따라 오류 응답 ( 4xx5xx )는 다음을 포함하는 하나 이상의 맵의 오류 응답 목록으로 구성됩니다. 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_ID , CLIENT_GEO , CLIENT_IP , DOMAIN , POLICY_ERROR [1]
    SOURCES_RESTRICTED TVE_AUTH
    SERVER_ERROR LOOKUP_GEO
    SERVER_TIMEOUT LOOKUP_GEO

    참고

    [1] ACCESS_DENIED / POLICY_ERROR정책을 평가하는 동안 예기치 않은 오류 (지역 제한 계정에 대한 비디오 정보 가져 오기 포함)를 의미합니다. 이 오류와 함께 로그에서 예외를 확인하는 것이 좋습니다.