오류 처리

모든 API 오류는 일관된 형식을 따라요. 오류를 깔끔하게 처리하는 방법을 알아보세요.

오류 응답 형식

오류가 발생하면 API는 다음 구조의 JSON 객체를 반환해요:

json

{
  "error": "Validation Error",
  "message": "The email field is required.",
  "status_code": 422
}

상태 코드	오류	원인 및 해결 방법
`400`	잘못된 요청	JSON 형식이 잘못되었거나 필수 필드가 빠졌어요. 요청 본문을 확인하세요.
`401`	인증 실패	API 키가 없거나 올바르지 않아요. `Authorization` 헤더를 확인하세요.
`402`	결제 필요	크레딧이 부족해요. 크레딧을 추가로 구매하거나 일일 한도가 초기화될 때까지 기다려 주세요.
`422`	유효성 검사 오류	이메일 주소 형식이 올바르지 않아요. 보내는 값을 확인하세요.
`429`	요청 과다	요청 한도를 초과했어요. `Retry-After` 헤더를 확인하고 그만큼 기다려 주세요.
`500`	내부 서버 오류	저희 쪽에서 문제가 발생했어요. 몇 초 후 다시 시도해 주세요. 오류가 계속되면 고객 지원팀에 문의해 주세요 .

json

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key",
  "status_code": 401
}

해결 방법: 요청의 Authorization 헤더가 다음 형식인지 확인하세요: Bearer YOUR_API_KEY. 대시보드에서 API 키도 확인해 주세요.

json

{
  "error": "Validation Error",
  "message": "The email field must be a valid email address.",
  "status_code": 422
}

해결 방법: 이메일 값이 올바른 이메일 형식인지 확인하세요(예: user@example.com). 보내기 전에 입력값을 정리하세요.

json

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please slow down.",
  "status_code": 429,
  "retry_after": 15
}

해결 방법: 다시 시도하기 전에 retry_after 값(초)만큼 기다리세요. 참고: 요청 한도 →