에러 코드

오류 응답 형식

오류 발생 시 다음과 같은 JSON 형식으로 응답합니다.

{
  "error": {
    "code": "E4001",
    "message": "API key is required. Provide X-API-Key header.",
    "details": "optional additional info"
  }
}

코드	HTTP	설명
`E4001`	`401`	API 키가 필요합니다. X-API-Key 헤더를 제공하세요.
`E4002`	`401`	유효하지 않은 API 키

코드	HTTP	설명
`E4101`	`403`	권한이 없습니다

코드	HTTP	설명
`E4301`	`404`	리소스를 찾을 수 없습니다
`E4302`	`409`	리소스가 준비되지 않았습니다

코드	HTTP	설명
`E4401`	`429`	사용량 한도를 초과했습니다
`E4402`	`429`	게스트 일일 한도를 초과했습니다

코드	HTTP	설명
`E4501`	`405`	허용되지 않은 메서드입니다