ما أطلقناه هذا الشهر: الترميز الجغرافي وIP والمنطقة الزمنية والمزيد
ملخص للعمل الأخير في الواجهة: مضيفات توافق جديدة، واستعلامات أسرع للمنطقة الزمنية والارتفاع، وميزات جديدة في لوحة التحكم، ورؤية أوضح للحصة.
شرح حدود معدل الطلبات بلغة بسيطة
لحدود معدل الطلبات سمعة بأنها مربكة، مليئة بالاستثناءات والشروط الدقيقة التي لا تتضح إلا بعد أن يتعطل شيء ما. أما حدودنا فأبسط من ذلك، وتستحق أن تُعرض بوضوح في مكان واحد.
يحصل كل عنوان على 2,500 طلب مجاني يوميًا دون أي مفتاح على الإطلاق. وهذه الحصة ليست لكل عنوان منفردًا، بل مشتركة عبر الشبكة: كل عناوين IPv4 في الكتلة /24 نفسها وكل عناوين IPv6 في الكتلة /48 نفسها تسحب من مجمع واحد معًا. ويهم ذلك إذا كنت خلف اتصال مكتبي مشترك أو إعداد كبير لترجمة عناوين الشبكة (NAT)، لأن حصتك المجانية مشتركة مع كل من يستخدم مقطع الشبكة نفسه، سواء كانوا يستخدمون مفتاحًا أم لا.
يحصل كل مفتاح أيضًا على حصة يومية مجانية خاصة به قدرها 2,500 طلب، منفصلة عما توفره الشبكة أصلًا. ولا تنقص حصة المفتاح بسبب الزيارات الأخرى على الشبكة نفسها، ولا تنقص حصة الشبكة بسبب زيارات استهلكت بالفعل الحصة المنفصلة لمفتاح ما. فالحصتان تقفان جنبًا إلى جنب بدلًا من أن تتنافسا.
بعد تجاوز الحصتين في يوم معين، إما أن يُخصم الطلب من الرصيد مسبق الدفع بسعر 0.0001 € للطلب، أو تغطيه باقة Unlimited بسعر 50 € شهريًا، بحسب ما أعده الحساب. لا يوجد إبطاء يؤخر الطلبات بصمت، ولا حظر مفاجئ دون تفسير. فكل استجابة تحمل ترويسات الحصة، X-Quota-Limit وX-Quota-Used وX-Quota-Free-Remaining وX-Quota-Network-Used وX-Credits-Remaining وX-Key-IPs-Used وX-Key-IPs-Limit وX-Quota-Reset، لذلك يكون موقف الطلب واضحًا تمامًا قبل أن يفشل أصلًا.
يتبع الاستدعاء المجمّع أو الدفعي القواعد نفسها على مستوى العنصر، لا على مستوى الاستدعاء. فمئة عنوان مرسلة في استدعاء واحد تُحتسب كمئة طلب من الحصة المطبقة، تمامًا كما لو أُرسلت في مئة استدعاء منفصل.
ينطبق كل هذا بالطريقة نفسها على كل نقطة نهاية وعلى كل واحد من مضيفات التوافق السبعة عشر. فالطلب المصاغ بصيغة OpenCage أو ipstack يخضع لحد المعدل وفق القواعد نفسها تمامًا التي يخضع لها طلب مباشر إلى /v1/forward أو /v1/ip، دون أي حد منفصل أشد صرامة يختبئ خلف شكل استجابة مألوف.
التفاصيل الكاملة، بما فيها طريقة عمل إعادة الضبط اليومية ومعنى كل ترويسة، موثقة في /docs/rate-limits/. وإذا ظهر سؤال عن حد المعدل في تكاملك يومًا، فالإجابة تكون في الغالب ظاهرة مباشرة في ترويسات الاستجابة التي تسببت فيه.