محدودیت نرخ درخواست
تعداد درخواستها برای هر توکن دسترسی محدود است. هر پاسخ میگوید چقدر از سهمیهتان باقی مانده است و درخواستی که از سقف بگذرد، خطای 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) را در کلاینت خود پیاده کنید تا یک موج ناگهانی درخواست، بهجای کوبیدن مداوم به سقف، بهتدریج پخش شود.
ویرایش این صفحه در گیتهابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.