محدودیت‌ها و سهمیه‌های نرخ — API پروفایل واتس‌اپ

سهمیه ماهانه به ازای هر ردیف

محدودیت‌های عکاسی پیاپی/برثانیه

محدودیت burst در هر ردیف، از سوءاستفاده از یک کلید واحد جلوگیری می‌کند:

مشتریان مگا که به افزایش مداوم حجم تراکنش نیاز دارند، می‌توانند از طریق مدیریت حساب اختصاصی، محدودیت سفارشی درخواست کنند.

هدرهای محدودیت نرخ

هر پاسخ شامل هدرهای با حروف کوچک (قرارداد RapidAPI) برای ردیابی سهمیه ماهانه است:

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

429 درخواست‌های بیش از حد

نقض محدودیت Burst-limit (درخواست‌ها خیلی نزدیک به هم) HTTP 429 را با یک متن خطای کوتاه برمی‌گرداند:

HTTP/1.1 429 Too Many Requests

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

عبارت 0.5 ثانیه‌ای نشان‌دهنده‌ی مقدار پیش‌فرض minIntervalSeconds در اکثر پلن‌ها (= 2 req/sec) است. برای مشاهده‌ی مقدار دقیق پلن خود، به /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} اضافه کنید - درخواست جدید همچنان جزو سهمیه محسوب می‌شود.

مرتبط