Rate limit

• Rate limit là tốc độ bạn có thể gọi API, được kiểm tra trên mọi request đã xác thực.
• Các hạn mức còn lại gồm phút FFmpeg, số Profile và số DM mỗi ngày vẫn giới hạn theo gói; riêng số bài đăng thì không. Xem Mức sử dụng để biết số liệu hiện tại.

​

Giới hạn cụ thể

• Cửa sổ cố định 60 giây, tính theo từng tài khoản khách hàng (không tính theo từng API key hay từng profile).
• Mặc định 120 request/phút. Đây là mức tiêu chuẩn, không phải giới hạn tuyệt đối. MADIAD Hub có thể nâng trần này cho tích hợp có lưu lượng lớn, liên hệ hỗ trợ nếu bạn cần cao hơn.
• Đây là cửa sổ cố định: bộ đếm được reset ở mỗi mốc 60 giây, nên lượng dùng không cộng dồn sang cửa sổ kế tiếp.

​

Khi vượt giới hạn

HTTP/1.1 429 Too Many Requests
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded (120/min). Slow down and retry shortly."
  }
}

​

Xử lý lỗi 429

• Tuân theo Retry-After. Header này cho biết chính xác cần chờ bao nhiêu giây trước khi thử lại, đừng gửi lại sớm hơn.
• Backoff theo cấp số nhân nếu bạn gọi API trong vòng lặp hoặc từ một worker xử lý hàng đợi và liên tục gặp 429, thay vì dồn dập gửi request mỗi khi cửa sổ reset.
• Giãn cách các đợt gửi liên tiếp. Nếu bạn đang tạo nhiều bài đăng cùng lúc (ví dụ lên lịch hàng loạt từ một script), hãy thêm một khoảng trễ nhỏ giữa các request thay vì thực hiện đồng thời tất cả.

​

Khi bản thân rate limiter gặp sự cố