Rate limits
429/5xx 응답을 백오프와 멱등 재시도로 처리하는 방법.
이번 릴리스에서는 고정된 요청 한도나 분석 SLA를 보장하지 않습니다. 다만 운영 상황에 따라 429 Too Many Requests 또는 일시적인 5xx 응답이 발생할 수 있으므로, 클라이언트는 아래의 방어적 재시도 가이드를 따르는 것이 좋습니다.
429 응답 헤더
429가 발생할 경우 다음 헤더가 함께 내려올 수 있습니다. 이 중 백오프에 믿고 사용할 수 있는 값은 Retry-After뿐입니다. 나머지 두 헤더는 게이트웨이가 보낼 수도 있지만 현재 API 계약상 보장되지 않으므로, 클라이언트 로직이 이 값에 의존하지 않도록 하세요.
| 헤더 | 의미 |
|---|---|
Retry-After | 재시도까지 대기할 초. 백오프 시 이 값을 기준으로 사용하세요. |
RateLimit-Remaining | 현재 창에서 남은 요청 수(참고용, 보장되지 않음). |
RateLimit-Reset | 한도 관련 참고 값(보장되지 않음). 백오프 대기 시간은 이 값으로 계산하지 말고 Retry-After를 사용하세요. |
HTTP/1.1 429 Too Many Requests
Retry-After: 12
RateLimit-Remaining: 0
RateLimit-Reset: 1750733000권장 처리
429와5xx는 지수 백오프와 지터로 재시도하세요.- 재시도할 때
Idempotency-Key를 그대로 유지해 중복 생성을 막으세요. - 짧은 시간에 요청이 몰릴 때는 동시 호출 수를 제한하고 큐에 쌓아 일정한 속도로 내보내세요.
문의
요청 처리량이나 운영 관련 협의가 필요하면 support@autopedia.ai로 문의하세요.