요청 제한

요청 제한 정책

요청 제한은 시간 단위당 API 호출 횟수 제한을 의미합니다. DFINERY는 안정적인 서비스 운영을 위해 제공하는 모든 Open API에 요청 제한 정책을 적용합니다.

분류	Rate Limit (기본)
Event	1분당 1,000,000건
Identity	1분당 10,000건
Profile	1분당 10,000건
Export	1시간당 100건, 동시간 5건

요청 제한을 초과하면 이후의 API 요청은 모두 실패합니다. 제한 시간이 지나 요청 제한이 초기화된 후 정상 응답을 받을 수 있습니다. API 연동 시 요청 제한을 고려하여 연동하는 것이 좋습니다.

기본으로 제공되는 요청 제한보다 많은 호출이 필요하다면 고객 성공팀에 문의 부탁드립니다.

요청 제한 현황 확인

요청 제한 현황은 응답 헤더의 값을 통해 확인할 수 있습니다.

헤더 이름	설명
X-Rate-Limit-Limit	초기화 주기
X-Rate-Limit-Remaining	남은 요청 횟수
X-Rate-Limit-Reset	발송 속도가 초기화되는 시간

X-Rate-Limit-Limit 은 1y: 1년, 1M: 1개월, 1d: 1일, 1H: 1시간, 1m: 1분, 1s: 1초로 구성됩니다.

X-Rate-Limit-Rest 은 Timestamp 형식입니다. 1719397769

요청 제한 현황 응답 예시

정상 응답

curl -i https://openapi.dfinery.ai/api/v1/...
> HTTP/2 200
> x-ratelimit-limit: 1d
> x-ratelimit-remaining: 99999
> x-ratelimit-reset: 1682593200268

API 호출 제한을 초과하는 경우 (응답 코드 429)

curl -i https://openapi.dfinery.ai/api/v1/...
> HTTP/2 429
> x-ratelimit-limit: 1d
> x-ratelimit-remaining: 0
> x-ratelimit-reset: 1682640000000