오류 코드

API 오류 응답 이해하기

에러 응답 형식

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

{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}

오류 코드

400Bad Request

요청 매개변수가 유효하지 않거나 형식이 잘못되었습니다.

솔루션: 요청 본문을 확인하고 모든 필수 필드가 유효한 값으로 채워져 있는지 확인해 주세요.

401Unauthorized

유효하지 않거나 누락된 API 키입니다.

솔루션: Authorization 헤더에 유효한 API 키를 포함하고 있는지 확인하세요.

402Payment Required

API 지갑에 충전된 크레딧이 부족합니다.

솔루션: 크레딧을 추가로 구매하거나 크레딧이 충전될 때까지 기다려 주세요.

403Forbidden

API 접근 권한이 승인되지 않았거나 계정이 정지되었습니다.

솔루션: 오류로 생각되면 지원팀에 문의해 주세요.

404Not Found

요청한 리소스(작업, 웹훅 등)를 찾을 수 없습니다.

솔루션: 리소스 ID가 정확한지 확인하세요.

429Too Many Requests

짧은 시간 내에 너무 많은 요청이 발생했습니다.

솔루션: 지수 백오프를 구현하고 속도 제한을 준수하세요.

500Internal Server Error

저희 측에서 문제가 발생했습니다.

솔루션: 짧은 지연 후에 요청을 다시 시도하세요. 문제가 계속되면 지원팀에 문의하세요.

요청 제한

기본 요청 제한: