مستندات

جست‌وجو در مستندات

نام اندپوینت، موضوع یا کلیدواژه را بنویسید

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

تعداد درخواست‌ها برای هر توکن دسترسی محدود است. هر پاسخ می‌گوید چقدر از سهمیه‌تان باقی مانده است و درخواستی که از سقف بگذرد، خطای 429 می‌گیرد.

هدرها#

هر پاسخ سهمیهٔ فعلی شما را گزارش می‌کند:

هدرمعنا
X-RateLimit-Limitتعداد درخواست مجاز در هر دقیقه.
X-RateLimit-Remainingتعداد درخواست باقی‌مانده در پنجرهٔ زمانی فعلی.
Retry-Afterچند ثانیه باید صبر کنید؛ فقط در پاسخ 429 می‌آید.

وقتی به سقف می‌رسید#

درخواست محدودشده، 429 Too Many Requests را با بدنهٔ استاندارد خطا برمی‌گرداند:

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "Too many requests. Slow down and retry.",
    "request_id": "req_…"
  }
}
صبر کنید و دوباره تلاش کنید. به اندازهٔ Retry-After صبر کنید و سپس دوباره درخواست بدهید. تأخیر نمایی (exponential backoff) را در کلاینت خود پیاده کنید تا یک موج ناگهانی درخواست، به‌جای کوبیدن مداوم به سقف، به‌تدریج پخش شود.
ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.