الأدلة

راقب استخدام مفتاحك قبل أن تبلغ الحد

أن تكتشف اقترابك من حدك اليومي لأن طلبًا رُفض للتو هو أقل الطرق فائدة لاكتشاف ذلك. فكل استجابة تحمل بالفعل الأرقام اللازمة لرؤيته قادمًا.

الترويسات التي يجب مراقبتها

X-Quota-Limit: 2500
X-Quota-Used: 2210
X-Quota-Free-Remaining: 290
X-Quota-Network-Used: 2210
X-Credits-Remaining: 5.75
X-Key-IPs-Used: 2
X-Key-IPs-Limit: 3
X-Quota-Reset: 2026-09-22T00:00:00Z

تناقص X-Quota-Free-Remaining نحو الصفر هو أوضح إشارة مبكرة لديك بشأن الحصة اليومية المجانية. ويخبرك X-Credits-Remaining بالمدى المتبقي لديك بعد تجاوز الحصة المجانية والبدء في السحب من الرصيد المسبق الدفع بسعر 0.0001 € للطلب.

تحديد عتبة التنبيه الخاصة بك

بدلًا من انتظار 429، سجّل أو أطلق تنبيهًا بمجرد أن ينخفض X-Quota-Free-Remaining تحت عتبة تختارها، مثل 10 بالمئة من X-Quota-Limit، ليتوفر وقت للتصرف، سواء كان ذلك بإبطاء مهمة مجمّعة، أو شحن الرصيد، أو ببساطة توقع فترة هدوء حتى X-Quota-Reset.

مراقبة خانات IP للمفتاح أيضًا

يتتبع X-Key-IPs-Used وX-Key-IPs-Limit عدد عناوين المصدر المختلفة التي استخدمت مفتاحًا معينًا ضمن حصة خانات IP المتجددة الخاصة به. والمفتاح الذي يُستخدم فجأة من عناوين أكثر من المتوقع ويقترب من حده يستحق التحقيق بحد ذاته، بمعزل عن حجم الطلبات، لأنه قد يشير إلى أن المفتاح يُتداول على نطاق أوسع مما هو مقصود.

بناء لوحة معلومات بسيطة

سكربت صغير يسجل هذه الترويسات لعينة من الطلبات، أو لكل طلب إذا كان الحجم منخفضًا بما يكفي، يمنحك اتجاه الاستخدام بمرور الوقت دون الحاجة إلى استدعاء مراقبة منفصل، لأن الأرقام تصل ضمن الاستجابات التي كنت تتلقاها أصلًا. ورسم X-Quota-Used مقابل الزمن على مدار يوم أو أسبوع يُظهر أنماط استخدام لا تُظهرها أبدًا لقطة واحدة.

التصرف قبل الاصطدام بالجدار

بمجرد أن ترى نمطًا ثابتًا من الاقتراب من حدك، يكون الطريقان المتاحان هما الخياران نفسهما المتاحان في أي وقت: أضف رصيدًا مسبق الدفع للتجاوزات العرضية، أو انتقل إلى مفتاح Unlimited بسعر 50 € شهريًا إذا كنت تتجاوز الحصة المجانية باستمرار. واتخاذ أي من القرارين بهدوء ومسبقًا أسهل من اتخاذه ردًا على 429 فعلي يحجب حركة مرور حقيقية.

قراءة ترويسات الحصة كقياسات روتينية، وليس فقط كشيء يُفحص عند فشل طلب، تحوّل الحد الصارم إلى اتجاه يمكن إدارته. والحصة الحالية وخيارات الرصيد موجودة في صفحة الأسعار، والتعريفات الكاملة للترويسات موجودة في توثيق حدود معدل الطلبات.