오류 코드

HTTP 상태와 공통 오류 응답으로 문제를 확인합니다.

오류 응답 · 형식 예시

{
  "code": "INVALID_INPUT",
  "message": "프로필 입력 또는 출력 규격이 맞지 않습니다.",
  "request_id": "<서버 요청 ID>"
}

주요 요청 오류

HTTP	코드	확인 사항
401	`UNAUTHORIZED / INVALID_API_KEY`	Bearer 헤더·키 만료·폐기를 확인하세요.
403	`FORBIDDEN / SUSPENDED`	키 권한과 업체의 활성 상태를 확인하세요.
404	`NOT_FOUND`	현재 업체·환경·프로필 범위의 자원인지 확인하세요.
409	`IDEMPOTENCY_CONFLICT`	다른 입력은 새로운 멱등키로 요청하세요.
422	`INVALID_REQUEST / INVALID_INPUT`	요청 형식과 프로필 입력·출력 규격을 확인하세요.
409	`INSUFFICIENT_CREDITS`	가용 크레딧과 예약 금액을 확인하세요.
429	`USAGE_LIMIT`	요청·동시 실행·예산 한도를 확인하세요.
422	`UPLOAD_INCOMPLETE / INVALID_FILE`	업로드된 파일과 확정 절차를 확인하세요.

접수 응답이 불확실하면 같은 입력과 같은 멱등키로 재시도합니다. 취소 접수와 실제 취소 완료는 다르며, 대사 중인 작업을 새 요청으로 중복 생성하지 마세요.

오류 문의에는 request_id와 작업 ID를 전달하세요. API 키와 제공사 내부 데이터는 포함하지 않습니다.