Giới hạn và hạn mức sử dụng — API hồ sơ WhatsApp

Hạn mức hàng tháng cho mỗi cấp

Giới hạn mỗi giây

Giới hạn truy cập tức thời cho mỗi cấp độ giúp ngăn chặn việc lạm dụng từ một khóa duy nhất:

Khách hàng MEGA cần lưu lượng truy cập cao hơn liên tục có thể yêu cầu giới hạn tùy chỉnh thông qua người quản lý tài khoản chuyên trách.

Tiêu đề giới hạn tốc độ

Mỗi phản hồi đều bao gồm các tiêu đề viết thường (theo quy ước của RapidAPI) để theo dõi hạn mức hàng tháng:

x-ratelimit-requests-limit:     60000
x-ratelimit-requests-remaining: 59999
x-ratelimit-requests-reset:     2591983   # seconds until reset

429 Yêu cầu quá nhiều

Lỗi vi phạm giới hạn số lượng yêu cầu gửi quá gần nhau (burst-limit violation) trả về mã lỗi HTTP 429 kèm theo nội dung lỗi ngắn gọn:

HTTP/1.1 429 Too Many Requests

{
  "error": "Requests must be at least 0.5 seconds apart"
}

Cụm từ "cách nhau 0,5 giây" phản ánh giá trị minIntervalSeconds mặc định trên hầu hết các gói dịch vụ (= 2 yêu cầu/giây). Hãy kiểm tra /api-key-stats → roleInfo.minIntervalSeconds để biết giá trị chính xác cho gói dịch vụ của bạn.

Kiểm tra hạn ngạch của bạn

Máy chủ proxy cung cấp phương thức GET /api-key-stats — bạn có thể gọi phương thức này bất cứ lúc nào để xem số liệu thống kê trực tiếp:

{
  "key": "08dc53d3-...",
  "role": "pro_60",
  "status": "active",
  "requestLimit": 60000,
  "requestRemaining": 59999,
  "requestReset": 2591982,
  "resetAt": "2026-05-27T02:24:56.708Z",
  "expiresAt": "2026-05-27T02:24:56.708Z",
  "lastUsedAt": "2026-04-27T02:25:12.955Z",
  "requestCountMonth": 1,
  "maxMonthlyUsage": 60000,
  "roleInfo": {
    "name": "pro_60",
    "maxMonthlyUsage": 60000,
    "minIntervalSeconds": 0.5
  }
}

Chính sách bộ nhớ đệm

Dữ liệu hồ sơ được lưu vào bộ nhớ đệm ở phía máy chủ. Các yêu cầu tra cứu lặp lại cho cùng một số trong khoảng thời gian bộ nhớ đệm sẽ được phục vụ từ bộ nhớ đệm. Để buộc thực hiện tra cứu mới, hãy thêm ?forceBypassCache=1 vào /number/{number} — yêu cầu mới vẫn được tính vào hạn mức.

Có liên quan