요청 제한

과도한 요청을 방지하기 위해 API 키와 엔드포인트 단위로 요청 제한이 적용됩니다.

rate_limit_exceeded

요청 제한을 초과하면 429 상태 코드와 함께 rate_limit_exceeded 오류가 반환됩니다.

{
  "error": "rate_limit_exceeded",
  "message": "too many requests"
}

엔드포인트별 추가 제한

• Bank 충전 요청은 동일 platform에 대해 재충전 쿨다운이 적용되며, 초과 시 429 cooldown_active가 반환됩니다.
• Email 발송은 요청 제한 외에도 일일/월간 발송 한도가 있으며, 초과 시 429 daily_limit_exceeded 또는 429 monthly_limit_exceeded가 반환됩니다.

Retry-After 헤더

429 응답에는 Retry-After 헤더가 포함될 수 있습니다. 이 값(초)이 지난 후에 재시도하세요. 헤더가 없다면 지수 백오프(exponential backoff) 방식으로 재시도 간격을 늘려가는 것을 권장합니다.