콘텐츠로 이동
한국어

오류와 반복

오류 형식

오류 응답에는 detail: 문자열, code/message이 있는 개체 또는 유효성 검사 오류 목록이 포함됩니다. 번역된 텍스트에서 동작을 결정하지 마십시오. 존재하는 경우 HTTP-status 및 기계 생성 code을 사용하십시오.

{"detail":"..."}
{"detail":{"code":"...","message":"..."}}

코드 HTTP

400
헤더 또는 식별자가 잘못되었습니다. 요청을 확인하세요.
401
세션 또는 키가 승인되지 않았습니다. 다시 로그인하거나 키를 확인하세요.
403
권한이 부족하거나 사서함에 대한 액세스가 거부되었습니다.
404
리소스를 찾을 수 없거나 현재 계정에서 사용할 수 없습니다.
409
폴더 상태, 할당량 또는 세대 충돌. 다시 시도하기 전에 데이터를 업데이트하세요.
413
파일 크기가 허용된 한도를 초과했습니다.
422
요청 매개변수가 잘못되었습니다. 응답에 제공된 필드를 확인하세요.
429
요청이 너무 많습니다. 나중에 다시 시도해 주세요.
503
일시적으로 서비스를 이용할 수 없습니다. 지연된 요청을 다시 시도하십시오.

401 이후에는 새로 로그인해야 합니다. 409 이후에는 상태를 다시 읽어보세요. 503 이후에는 지연을 두고 반복합니다. 보내려면 동일하게 Idempotency-Key. 되돌릴 수 없는 행동을 맹목적으로 반복하지 마십시오.