كل مفتاح API له حد معدّل لكل دقيقة. تتمتع مفاتيح الإنتاج بسقف أعلى من مفاتيح
بيئة الاختبار؛ ويتجاوز الحدُّ المُحدَّد صراحةً لكل مفتاح في لوحة التحكم الحدَّ
الافتراضي.
| البيئة | الحد الافتراضي |
|---|
الإنتاج (tg_live_) | 1,000 طلب / دقيقة |
بيئة الاختبار (tg_test_) | 100 طلب / دقيقة |
ترويسات الاستجابة
تتضمن كل استجابة وضعك الحالي في النافذة الزمنية:
| الترويسة | المعنى |
|---|
X-RateLimit-Limit | الحد الأقصى للطلبات المسموح بها في النافذة |
X-RateLimit-Remaining | الطلبات المتبقية في النافذة الحالية |
Retry-After | عدد الثواني التي يجب الانتظارها (يظهر فقط مع 429) |
عند تجاوز الحد
ستتلقى 429 Too Many Requests:
{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "API key rate limit exceeded",
"details": { "limit": 1000, "window": "1 minute", "retry_after_seconds": 60 }
}
}
تراجع وأعد المحاولة بعد عدد الثواني المحدد في Retry-After، ويُفضّل ذلك مع
تراجع أُسي وعشوائية. وزّع الأعمال المجمّعة على فترات بدلاً من إرسالها دفعة واحدة.
