راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
قراءة الترويستين X-Quota-Used وX-Quota-Limit بشكل صحيح
كل استجابة من الواجهة، ناجحة كانت أم لا، تحمل مجموعة من الترويسات تصف موقفك بالضبط مقارنة بحصتك. وقراءتها بشكل صحيح تعني فهم ما تحتسبه كل واحدة منها.
الزوج الأساسي
X-Quota-Limit هي حجم حصتك الحالية، سواء كانت الحصة اليومية المجانية أو الحد الفعلي ضمن باقة Unlimited. وX-Quota-Used هي عدد الطلبات التي احتُسبت من تلك الحصة حتى الآن في الفترة الحالية. ولا حاجة إلى طرح إحداهما من الأخرى يدويًا، لأن X-Quota-Free-Remaining تفعل ذلك نيابة عنك.
HTTP/1.1 200 OK
X-Quota-Limit: 2500
X-Quota-Used: 1840
X-Quota-Free-Remaining: 660
X-Quota-Network-Used: 1840
X-Credits-Remaining: 0.00
X-Key-IPs-Used: 1
X-Key-IPs-Limit: 3
X-Quota-Reset: 2026-09-22T00:00:00Zاستخدام المفتاح مقابل استخدام الشبكة
تعكس X-Quota-Used الاستخدام المرتبط بمفتاحك، بينما تعكس X-Quota-Network-Used الاستخدام الصادر من الشبكة المحيطة، لأن الحصة المجانية مشتركة بين كل عناوين IPv4 في الكتلة /24 نفسها وكل عناوين IPv6 في الكتلة /48 نفسها، سواء كان هناك مفتاح أم لا. فإذا استُدعي مفتاح من عدة خوادم خلف كتلة العناوين نفسها، سيرتفع رقم الشبكة أسرع مما يتوقعه أي خادم منفرد من زياراته الخاصة.
زوج خانات IP
تصف X-Key-IPs-Used وX-Key-IPs-Limit شيئًا مختلفًا تمامًا: عدد عناوين المصدر المختلفة التي استخدمت هذا المفتاح تحديدًا مؤخرًا، مقارنة بالحد المتحرك البالغ عنوانين أو ثلاثة عناوين مسموح بها لكل مفتاح. فالمفتاح الذي يُستدعى من خادم واحد سيُظهر هنا قيمة ثابتة هي 1. أما المفتاح المشترك بين عدة خوادم غير مترابطة، أو المنسوخ في سكربت ينتهي به الأمر إلى العمل من أجهزة كثيرة، فسيرتفع نحو الحد، وهذا يستحق المراقبة بشكل منفصل عن حصة طلباتك، لأنه قد يحظر المفتاح حتى عندما يتبقى عدد كبير من الطلبات المجانية.
الرصيد وموعد إعادة الضبط
تُظهر X-Credits-Remaining رصيدك مسبق الدفع بمجرد تجاوزك الحصة المجانية وبدء الخصم من الرصيد بسعر 0.0001 € للطلب. وتخبرك X-Quota-Reset بالضبط متى تُعاد الحصة اليومية الحالية، وهذا أكثر موثوقية من افتراض وقت ثابت بناءً على ساعتك الخاصة.
ما الذي تبنيه على أساس هذه الترويسات
لوحة متابعة، أو تنبيه، أو مجرد سطر في السجل يقرأ هذه الترويسات بعد كل استدعاء، يعطيك صورة حية للاستخدام دون الحاجة إلى استدعاء منفصل للتقارير، لأن الأرقام تصل مع الاستجابة التي طلبتها أصلًا. وقراءتها لا تكلف شيئًا إضافيًا، لأنها تأتي مع كل طلب كنت ترسله بالفعل، سواء نجح ذلك الطلب أو عاد بخطأ.
خطأ يستحق التجنب
قراءة هذه الترويسات فقط عندما يحدث خطأ ما تعني أنك تكتشف مشكلة الحصة في اللحظة نفسها التي يكتشفها فيها مستخدموك. سجّل على الأقل X-Quota-Free-Remaining وX-Credits-Remaining وفق جدول منتظم، أو بعد كل استدعاء في التكامل منخفض الزيارات، حتى يظهر الارتفاع البطيء نحو الحد كاتجاه في لوحة المتابعة بدلًا من دفعة مفاجئة من استجابات 429.
قراءة ترويسات الحصة في كل استجابة، بدلًا من انتظار 429 لملاحظة المشكلة، هي الفرق بين تباطؤ سلس وتباطؤ مفاجئ. القائمة الكاملة للترويسات موثقة في صفحة حدود معدل الطلبات.