1 of 1

요청 제한

요청 제한 정책

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

분류

Rate Limit (기본)

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

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

요청 제한 현황 확인

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

헤더 이름

설명

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

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

요청 제한 현황 응답 예시

정상 응답

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

요청 제한

요청 제한 정책

분류

Rate Limit (기본)

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

요청 제한 현황 확인

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

헤더 이름

설명

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

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

요청 제한 현황 응답 예시

정상 응답

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

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

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

요청 제한

hashtag요청 제한 정책

hashtag요청 제한 현황 확인

hashtag요청 제한 현황 응답 예시

hashtag정상 응답

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

요청 제한

hashtag요청 제한 정책

hashtag요청 제한 현황 확인

hashtag요청 제한 현황 응답 예시

hashtag정상 응답

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

요청 제한 정책

요청 제한 현황 확인

요청 제한 현황 응답 예시

정상 응답

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

요청 제한 정책

요청 제한 현황 확인

요청 제한 현황 응답 예시

정상 응답

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