호출 제한

개요#

호출 제한은 모든 사용자가 API 리소스를 공정하게 사용할 수 있도록 하고 서비스 안정성을 유지하기 위해 적용됩니다. 이 문서에서는 Deeply API의 호출 제한 정책과 한도에 도달했을 때의 대응 방법을 설명합니다.

엔드포인트별 호출 제한#

각 API 엔드포인트에는 다음 제한이 적용됩니다.

• 초당 10회 요청
• 분당 1,000회 요청

이 제한은 엔드포인트 단위로 추적되며 매초 자동으로 초기화됩니다.

더 높은 제한 요청#

애플리케이션에 더 높은 한도가 필요하다면 지원팀에 문의해 추가 한도를 요청해 주세요.

호출 제한 초과#

호출 제한을 초과하면 429 상태 코드와 함께 아래와 같은 응답 본문을 받게 됩니다.

{
  "detail": {
    "message": "호출 제한을 초과했습니다. 60초 후 다시 시도해 주세요.",
    "limit": 1000,
    "remaining": 0,
    "reset": 1640995200
  }
}

호출 제한 대응 권장 사항#

호출 제한에 걸리지 않도록 다음을 권장합니다.

1. 요청 큐잉 구현: 대량 작업은 요청을 큐에 넣고 제어된 속도(초당 최대 10회)로 처리하세요.