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 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. Xử lý video cũng có hạn mức, nhưng cấp theo từng tài khoản chứ không theo gói. 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).
• 60 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.
• Kết nối kênh nhập thủ công: 10 request/phút, đếm riêng, không nằm trong 60. POST /v1/connections/{platform} gửi một thông tin xác thực tới máy chủ do bạn chỉ định rồi báo có được chấp nhận hay không, nên nó được giữ chậm có chủ đích để không dùng được vào việc dò mật khẩu. Kết nối một kênh là việc làm một lần cho mỗi kênh; dùng bình thường không bao giờ chạm mức này. Xem Kênh.
• Đâ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 (60/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ố