حدود معدل الطلبات والحصص — واجهة برمجة تطبيقات ملف تعريف واتساب

الحصة الشهرية لكل مستوى

حدود السرعة / في الثانية

يمنع حدّ الاستخدام لكل مستوى إساءة استخدام مفتاح واحد:

يمكن لعملاء MEGA الذين يحتاجون إلى معدل تدفق أعلى بشكل مستمر طلب حد مخصص من خلال مدير الحساب المخصص.

رؤوس تحديد معدل الطلبات

تتضمن كل استجابة عناوين بأحرف صغيرة (وفقًا لاتفاقية RapidAPI) لتتبع الحصة الشهرية:

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

429 طلبات كثيرة جدًا

يؤدي انتهاك حد الاندفاع (الطلبات متقاربة جدًا) إلى إرجاع رمز HTTP 429 مع نص خطأ قصير:

HTTP/1.1 429 Too Many Requests

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

يشير مصطلح "بفارق 0.5 ثانية" إلى القيمة الافتراضية لـ minIntervalSeconds في معظم الباقات (أي طلبين في الثانية). راجع /api-key-stats → roleInfo.minIntervalSeconds لمعرفة القيمة الدقيقة لباقة اشتراكك.

تحقق من حصتك الخاصة

يُتيح الخادم الوكيل الوصول إلى GET /api-key-stats — قم باستدعائه في أي وقت لقراءة العداد المباشر:

{
  "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
  }
}

سياسة التخزين المؤقت

يتم تخزين بيانات الملف الشخصي مؤقتًا على الخادم. وتُستخدَم عمليات البحث المتكررة عن نفس الرقم ضمن نافذة التخزين المؤقت من ذاكرة التخزين المؤقت. لفرض عملية بحث جديدة، أضف ?forceBypassCache=1 إلى /number/{number} — سيُحتسب الطلب الجديد ضمن الحصة المخصصة.

متعلق ب