메인 콘텐츠로 건너뛰기
모든 오류 응답은 다음 형식을 따릅니다:
{
  "code": "ERROR_CODE"
}
HTTP 상태 코드가 오류 유형을 나타냅니다. 프로그래밍 방식의 오류 처리 및 i18n/로컬라이제이션에는 code 필드를 사용하세요.

인증 오류

오류 코드HTTP 상태설명
AUTH_NOT_AUTHENTICATED401인증 필요
AUTH_TOKEN_EXPIRED401인증 토큰 만료
AUTH_TOKEN_INVALID401유효하지 않은 인증 토큰
AUTH_TOKEN_INVALID_FORMAT401토큰 형식 오류
AUTH_FORBIDDEN403권한 부족

유효성 검사 오류

오류 코드HTTP 상태설명
VALIDATION_FAILED400입력 유효성 검사 실패
VALIDATION_IDEMPOTENCY_KEY_INVALID400유효하지 않은 멱등성 키
INVALID_PARAMETER400유효하지 않은 파라미터

주문 오류

오류 코드HTTP 상태설명
ORDER_NOT_FOUND404주문을 찾을 수 없음
ORDER_NOT_PENDING400주문이 대기 상태가 아님
ORDER_NOT_OWNER403주문 소유자가 아님
ORDER_EXPIRED400주문 만료
ORDER_NOT_COMPLETED400주문이 완료되지 않음
ORDER_FILE_NOT_UPLOADED400주문 파일이 업로드되지 않음
ORDER_ALREADY_CONFIRMED400이미 확인된 주문
ORDER_ALREADY_COMPLETED400이미 완료된 주문
ORDER_ALREADY_FAILED400이미 실패한 주문
ORDER_TYPE_NOT_MATCH400주문 유형 불일치
ORDER_TYPE_CANT_DOWNLOAD400다운로드 불가능한 주문 유형
ORDER_TIMEOUT408주문 처리 시간 초과

사용량 및 플랜 오류

오류 코드HTTP 상태설명
USAGE_LIMIT_EXCEEDED400사용량 한도 초과
USAGE_NOT_ENOUGH400사용량 할당량 부족
PLAN_NOT_FOUND404플랜을 찾을 수 없음

웹훅 오류

오류 코드HTTP 상태설명
WEBHOOK_NOT_FOUND404웹훅을 찾을 수 없음

요청 제한

오류 코드HTTP 상태설명
RATE_LIMIT_EXCEEDED429너무 많은 요청

서버 오류

오류 코드HTTP 상태설명
SERVER_INTERNAL_ERROR500내부 서버 오류