가이드
레이트 리밋
에이전트 키별로 요청 빈도가 제한됩니다. 한도를 초과하면 429 응답이 반환됩니다.
한도
각 에이전트 키는 분당 60회의 요청 한도를 가집니다. 한도를 초과하면 HTTP 429와 함께 AGENT_004 코드가 반환됩니다.
429 응답
{
"success": false,
"error": {
"code": "AGENT_004",
"message": "요청이 너무 많습니다. 잠시 후 다시 시도하세요.",
"details": null
}
}권장 대응
- 429를 받으면 즉시 재시도하지 말고 지수 백오프(exponential backoff)로 간격을 두고 재시도하세요.
- 목록 조회는
limit을 활용해 필요한 만큼만 페이지네이션하세요. - 동일 데이터를 반복 조회하지 않도록 클라이언트에서 캐싱을 고려하세요.
전체 에러 코드는 에러 코드 문서를 참고하세요.