Rate Limits

GLOBAL BRIDGE APIλŠ” λͺ¨λ“  μ„œλΉ„μŠ€μ˜ κ³΅μ •ν•˜κ³  μ•ˆμ •μ μΈ μ΄μš©μ„ μœ„ν•΄ API 호좜 μ œν•œ(Rate Limiting)을 μ μš©ν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€. μ œν•œ μ†λ„λŠ” κ³„μ •μ˜ ν”Œλžœμ— 따라 λ‹€λ₯΄λ©°, λͺ¨λ“  μ œν•œμ€ **API Key** λ‹¨μœ„λ‘œ κ³„μ‚°λ©λ‹ˆλ‹€.

Rate Limit Headers

λͺ¨λ“  API 응닡 ν—€λ”μ—λŠ” ν˜„μž¬μ˜ 호좜 μ œν•œ μƒνƒœλ₯Ό νŒŒμ•…ν•  수 μžˆλŠ” 정보가 ν¬ν•¨λ˜μ–΄ μ „λ‹¬λ©λ‹ˆλ‹€.

X-RateLimit-Limit

μ§€μ •λœ μ‹œκ°„(λΆ„) λ™μ•ˆ ν—ˆμš©λ˜λŠ” μ΅œλŒ€ μš”μ²­ νšŸμˆ˜μž…λ‹ˆλ‹€.

X-RateLimit-Remaining

ν˜„μž¬ μœˆλ„μš°(μ‹œκ°„ λ‹¨μœ„) λ‚΄μ—μ„œ 남은 μš”μ²­ κ°€λŠ₯ νšŸμˆ˜μž…λ‹ˆλ‹€.

X-RateLimit-Reset

μš”μ²­ νšŸμˆ˜κ°€ μ΄ˆκΈ°ν™”λ  λ•ŒκΉŒμ§€ 남은 μ‹œκ°„(UTC Epoch Seconds)μž…λ‹ˆλ‹€.

Default Quotas

Plan Rate Limit Monthly Cap
Free 60 req / min 10,000 req
Pro 500 req / min 1,000,000 req
Enterprise Unlimited* Custom
429 Too Many Requests 
HTTP/1.1 429 Too Many Requests
Content-Type: application/json
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
Retry-After: 35

{
  "status": "error",
  "code": "RATE_LIMIT_EXCEEDED",
  "message": "μš”μ²­ ν•œλ„λ₯Ό μ΄ˆκ³Όν–ˆμŠ΅λ‹ˆλ‹€. 35초 후에 λ‹€μ‹œ μ‹œλ„ν•΄μ£Όμ„Έμš”."
}
Handling Rate Limits

  • 응닡 ν—€λ”μ˜ Retry-After 값을 ν™•μΈν•˜μ—¬ λŒ€κΈ° μ‹œκ°„μ„ μ‘°μ ˆν•˜μ„Έμš”.

  • λŒ€λŸ‰μ˜ μš”μ²­μ΄ ν•„μš”ν•œ 경우 μ§€μˆ˜ λ°±μ˜€ν”„(Exponential Backoff) μ•Œκ³ λ¦¬μ¦˜μ„ μ‚¬μš©ν•˜μ„Έμš”.

호좜 μ œν•œμ— λ„λ‹¬ν•˜λ©΄ μ„œλ²„λŠ” μš”μ²­ 처리λ₯Ό μ€‘λ‹¨ν•˜κ³  HTTP 429 μƒνƒœ μ½”λ“œλ₯Ό λ°˜ν™˜ν•©λ‹ˆλ‹€.