가이드

레이트 리밋

에이전트 키별로 요청 빈도가 제한됩니다. 한도를 초과하면 429 응답이 반환됩니다.

한도

각 에이전트 키는 분당 60회의 요청 한도를 가집니다. 한도를 초과하면 HTTP 429와 함께 AGENT_004 코드가 반환됩니다.

429 응답
{
  "success": false,
  "error": {
    "code": "AGENT_004",
    "message": "요청이 너무 많습니다. 잠시 후 다시 시도하세요.",
    "details": null
  }
}

권장 대응

  • 429를 받으면 즉시 재시도하지 말고 지수 백오프(exponential backoff)로 간격을 두고 재시도하세요.
  • 목록 조회는 limit을 활용해 필요한 만큼만 페이지네이션하세요.
  • 동일 데이터를 반복 조회하지 않도록 클라이언트에서 캐싱을 고려하세요.
전체 에러 코드는 에러 코드 문서를 참고하세요.