Bỏ qua

Giới hạn tỷ lệ

Để đảm bảo hiệu suất và độ tin cậy cao cho tất cả người dùng, SMSBAT áp dụng giới hạn tốc độ cho các yêu cầu API. Giới hạn tốc độ chỉ định số lượng lệnh gọi API tối đa bạn có thể thực hiện trong một khung thời gian nhất định.

Giới hạn mặc định

Trừ khi có quy định khác trong hợp đồng của bạn, giới hạn tốc độ mặc định sẽ được áp dụng trên tất cả các điểm cuối API (API SMSBAT, API Cascade và API ChatHub).

Danh mục API Giới hạn mặc định Giới hạn bùng nổ
Điểm cuối nhắn tin (/bat/messagelist) 100 yêu cầu/giây 150 yêu cầu/giây
Điểm cuối dữ liệu (Trạng thái, Số dư, Thông tin) 50 yêu cầu/giây 75 yêu cầu/giây

[!LƯU Ý] Đối với tin nhắn gửi đi (ví dụ: POST /bat/messagelist), một yêu cầu HTTP có thể chứa tối đa 5.000 tin nhắn trong mảng messages. Giới hạn tốc độ áp dụng cho số lượng yêu cầu HTTP chứ không phải số lượng tin nhắn được gửi.

Giới hạn tỷ lệ xử lý

Nếu bạn vượt quá giới hạn tốc độ cho phép, API sẽ phản hồi bằng mã trạng thái HTTP 429 Quá nhiều yêu cầu.

Ví dụ về phản hồi

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please wait before sending more requests.",
  "status": 429
}

Các phương pháp hay nhất

Để tránh bị giới hạn tỷ lệ, hãy xem xét các phương pháp hay nhất sau:

  1. Gói tin nhắn của bạn: Thay vì gửi 1.000 yêu cầu HTTP riêng biệt cho 1.000 tin nhắn SMS, hãy gửi một yêu cầu duy nhất chứa một mảng gồm 1.000 đối tượng.
  2. Triển khai thời gian chờ theo cấp số nhân: Nếu bạn nhận được mã trạng thái 429, hãy đợi một khoảng thời gian ngắn (ví dụ: 1 giây) và thử lại. Nếu vẫn thất bại, hãy tăng gấp đôi thời gian chờ (2 giây, 4 giây, 8 giây, v.v.).
  3. Tốc độ yêu cầu của bạn: Nếu bạn đang chạy tập lệnh tự động kích hoạt hàng nghìn lệnh gọi API, hãy đưa ra một độ trễ nhỏ (ví dụ: sleep(10) mili giây) giữa các yêu cầu.

Yêu cầu tăng giới hạn

Nếu trường hợp sử dụng của bạn yêu cầu thông lượng cao hơn giới hạn mặc định, bạn có thể yêu cầu tăng.

  1. Liên hệ với người quản lý tài khoản chuyên dụng của bạn hoặc gửi email đến [email protected].
  2. Cung cấp ID tài khoản của bạn và thông lượng dự kiến ​​(ví dụ: 500 yêu cầu mỗi giây).
  3. Mô tả ngắn gọn trường hợp sử dụng của bạn.

Nhóm kỹ thuật của chúng tôi sẽ xem xét yêu cầu của bạn và điều chỉnh giới hạn của bạn cho phù hợp.