호출 제한
Deeply OpenAPI의 호출 제한 정책과 대응 방법을 설명합니다.
마지막 업데이트: 2026년 3월 26일
개요
호출 제한은 모든 사용자가 API 리소스를 공정하게 사용할 수 있도록 하고 서비스 안정성을 유지하기 위해 적용됩니다. 이 문서에서는 Deeply API의 호출 제한 정책과 한도에 도달했을 때의 대응 방법을 설명합니다.
엔드포인트별 호출 제한
각 API 엔드포인트에는 다음 제한이 적용됩니다.
- 초당 10회 요청
- 분당 1,000회 요청
이 제한은 엔드포인트 단위로 추적되며 매초 자동으로 초기화됩니다.
더 높은 제한 요청
애플리케이션에 더 높은 한도가 필요하다면 지원팀에 문의해 추가 한도를 요청해 주세요.
호출 제한 초과
호출 제한을 초과하면 429 상태 코드와 함께 아래와 같은 응답 본문을 받게 됩니다.
1
2
3
4
5
6
7
8
{
"detail": {
"message": "호출 제한을 초과했습니다. 60초 후 다시 시도해 주세요.",
"limit": 1000,
"remaining": 0,
"reset": 1640995200
}
}호출 제한 대응 권장 사항
호출 제한에 걸리지 않도록 다음을 권장합니다.
- 요청 큐잉 구현: 대량 작업은 요청을 큐에 넣고 제어된 속도(초당 최대 10회)로 처리하세요.