오류 코드 - BIZ MORI API Documentation

모든 오류 응답은 다음 형식을 따릅니다:

{
  "code": "ERROR_CODE"
}

HTTP 상태 코드가 오류 유형을 나타냅니다. 프로그래밍 방식의 오류 처리 및 i18n/로컬라이제이션에는 code 필드를 사용하세요.

인증 오류

오류 코드	HTTP 상태	설명
`AUTH_NOT_AUTHENTICATED`	401	인증 필요
`AUTH_TOKEN_EXPIRED`	401	인증 토큰 만료
`AUTH_TOKEN_INVALID`	401	유효하지 않은 인증 토큰
`AUTH_TOKEN_INVALID_FORMAT`	401	토큰 형식 오류
`AUTH_FORBIDDEN`	403	권한 부족

유효성 검사 오류

오류 코드	HTTP 상태	설명
`VALIDATION_FAILED`	400	입력 유효성 검사 실패
`VALIDATION_IDEMPOTENCY_KEY_INVALID`	400	유효하지 않은 멱등성 키
`INVALID_PARAMETER`	400	유효하지 않은 파라미터

주문 오류

오류 코드	HTTP 상태	설명
`ORDER_NOT_FOUND`	404	주문을 찾을 수 없음
`ORDER_NOT_PENDING`	400	주문이 대기 상태가 아님
`ORDER_NOT_OWNER`	403	주문 소유자가 아님
`ORDER_EXPIRED`	400	주문 만료
`ORDER_NOT_COMPLETED`	400	주문이 완료되지 않음
`ORDER_FILE_NOT_UPLOADED`	400	주문 파일이 업로드되지 않음
`ORDER_ALREADY_CONFIRMED`	400	이미 확인된 주문
`ORDER_ALREADY_COMPLETED`	400	이미 완료된 주문
`ORDER_ALREADY_FAILED`	400	이미 실패한 주문
`ORDER_TYPE_NOT_MATCH`	400	주문 유형 불일치
`ORDER_TYPE_CANT_DOWNLOAD`	400	다운로드 불가능한 주문 유형
`PROCESSED_FILE_NOT_FOUND`	404	주문에 처리 결과 파일이 없음
`ORDER_TIMEOUT`	408	주문 처리 시간 초과

테스트 업로드 오류

오류 코드	HTTP 상태	설명
`TEST_UPLOAD_TOO_LARGE`	413	테스트 업로드가 기본 50 MiB 제한을 초과함

사용량 및 플랜 오류

오류 코드	HTTP 상태	설명
`USAGE_LIMIT_EXCEEDED`	400	사용량 한도 초과
`USAGE_NOT_ENOUGH`	400	사용량 할당량 부족
`PLAN_NOT_FOUND`	404	플랜을 찾을 수 없음

웹훅 오류

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

요청 제한

오류 코드	HTTP 상태	설명
`RATE_LIMIT_EXCEEDED`	429	너무 많은 요청

서버 오류

오류 코드	HTTP 상태	설명
`SERVER_INTERNAL_ERROR`	500	내부 서버 오류