الخطوات الأولى

حد الطلبات

يمكن لكل مستخدم إرسال ما يصل إلى 120 طلبًا في الدقيقة، بجمع كل مفاتيحه. يُعاد ضبط العداد مع بداية كل دقيقة على الساعة.

تعرض الاستجابات للمفتاح الصالح الاستهلاك في هذه الترويسات:

عند تجاوز الحد، تكون الاستجابة 429 مع الرمز rate_limited. انتظر المدة المحددة في Retry-After قبل المحاولة مرة أخرى.

لتجنب بلوغ الحد

• استخدم per_page بقيمة تصل إلى 100 لجلب عناصر أكثر بطلبات أقل.
• لمتابعة حالة أجهزة التلفزيون، يكفي طلب واحد في الدقيقة.
• في المهام الكبيرة، وزّع الطلبات على فترات زمنية وراقب X-RateLimit-Remaining.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42

HTTP/1.1 429 Too Many Requests
Retry-After: 18
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 18

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 18 seconds."
  }
}