Giới hạn tần suất

Yêu cầu API được giới hạn tần suất theo từng khóa để bảo đảm sử dụng công bằng và giữ hệ thống ổn định.

Giới hạn

Giới hạn áp dụng cho từng khóa API. Nếu tích hợp của bạn dùng nhiều khóa, mỗi khóa có giới hạn riêng, độc lập với nhau.

Xử lý phản hồi 429

Khi vượt giới hạn, API trả về 429 Too Many Requests với header Retry-After:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{ "errors": ["Rate limit exceeded"] }

Giá trị Retry-After là số giây cần chờ trước khi thử lại.

import requests
import time

def api_get(url, token, retries=3):
    for attempt in range(retries):
        response = requests.get(url, headers={"Authorization": f"Bearer {token}"})
        if response.status_code == 429:
            wait = int(response.headers.get("Retry-After", 60))
            print(f"Rate limited. Waiting {wait}s...")
            time.sleep(wait)
            continue
        response.raise_for_status()
        return response.json()
    raise Exception("Rate limit retries exhausted")

Giữ trong giới hạn

Với các thao tác hàng loạt — đồng bộ một lượng tồn kho lớn, nhập nhiều dự án — hãy giãn các yêu cầu để trung bình dưới 1 yêu cầu mỗi giây.

Nếu tích hợp của bạn luôn cần hơn 60 yêu cầu mỗi phút, hãy liên hệ bộ phận hỗ trợ để trao đổi về giới hạn cao hơn cho tài khoản của bạn.