راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
بناء تكامل يعني عادة عشرات أو مئات من استدعاءات الاختبار قبل أن يقترب أي شيء من حركة الإنتاج، ولا يحتاج أي من هذا الاختبار إلى المساس بخطة مدفوعة.
يتوفر 2,500 طلب مجاني يوميًا من أي عنوان دون الحاجة إلى مفتاح على الإطلاق، وهذا يكفي لمعظم أعمال التكامل: تجهيز صيغة الطلبات، والتحقق من تحليل الاستجابات، والعمل على معالجة الأخطاء لعدد قليل من حالات الاختبار لكل منها.
GET /v1/forward?q=Test Address, Test City&limit=1لا ترويسة X-API-Key، ولا ترويسة Authorization، لا شيء سوى الطلب نفسه.
حتى دون مفتاح، تحمل كل استجابة ترويسات الحصة نفسها، فيمكنك مراقبة X-Quota-Used وX-Quota-Free-Remaining وهي ترتفع وتنخفض تمامًا كما ستفعل في بيئة الإنتاج، وهذا مفيد لاختبار طريقة تعامل شيفرتك مع تلك الترويسات قبل أن يصبح الأمر مهمًا فعلًا.
X-Quota-Limit: 2500
X-Quota-Used: 42
X-Quota-Free-Remaining: 2458بمجرد إنشاء حساب وتوليد مفتاح، يحصل هذا المفتاح أيضًا على 2,500 طلب مجاني يوميًا خاصة به، وهي مساحة اختبار منفصلة لا تمس الرصيد المسبق الدفع ولا تُحتسب ضمن باقة Unlimited. هذه هي المرحلة المناسبة لاختبار السلوك الخاص بالمفتاح، مثل الطرق المختلفة لإرسال المفتاح: الترويسة، أو رمز Bearer، أو المصادقة الأساسية، أو معامل الاستعلام، وكل ذلك دون إنفاق أي شيء.
أرسل طلبًا بمعامل غير صالح لترى 400، أو بمفتاح خاطئ عن قصد لترى 401، حتى تكون شيفرة معالجة الأخطاء لديك قد جُرّبت فعلًا قبل الإطلاق بدلًا من افتراض أنها تعمل. كل واحد من طلبات الاختبار هذه، ناجحًا كان أم لا، هو طلب واحد يُخصم من الحصة المجانية، وليس أمرًا ينبغي أن يقلقك عند أحجام الاختبار المعتادة.
بمجرد بدء الحركة الحقيقية، تواصل الحصة المجانية نفسها تغطية الاستخدام اليومي المعتاد لكثير من عمليات التكامل الصغيرة، ولا تحتاج إلى رصيد مسبق الدفع أو باقة Unlimited إلا عندما يتجاوز الحجم 2,500 طلب يوميًا.
لا حاجة هنا إلى بيئة اختبار (sandbox) منفصلة، لأن الحصة المجانية توفر بالفعل ساحة اختبار كاملة مع الـ API الحقيقي. ابدأ بتوليد مفتاح من لوحة التحكم، أو اقرأ توثيق المصادقة أولًا إذا أردت الاطلاع على صيغ المفاتيح قبل إنشاء حساب.