ما أطلقناه هذا الشهر: الترميز الجغرافي وIP والمنطقة الزمنية والمزيد
ملخص للعمل الأخير في الواجهة: مضيفات توافق جديدة، واستعلامات أسرع للمنطقة الزمنية والارتفاع، وميزات جديدة في لوحة التحكم، ورؤية أوضح للحصة.
أدلة الانتقال: مكان جديد لتبديل المزوّدين
أن تعرف بوجود مضيف متوافق شيء، وأن تعرف بالضبط كيف تنقل تكاملًا قائمًا إليه دون كسر أي شيء في الطريق شيء آخر. لذلك أنشأنا مجموعة مخصصة من أدلة الترحيل لسد هذه الفجوة، وجمعناها في /docs/compatibility/.
تشرح الأدلة الخطوات العملية للتبديل: ما الذي يتغير في الطلب، وما الذي يبقى كما هو، وأي طريقة مصادقة تُستخدم، وما الذي يجب الانتباه إليه في الاستجابة، مزودًا تلو الآخر ونقطة نهاية تلو الأخرى. ولأن كل مضيف من مضيفينا المتوافقين السبعة عشر يعيد إنتاج شكل الطلب والاستجابة لدى مزوده الأصلي بدقة، باستثناء نصوص حقوق النشر والشروط والخصوصية، تركز الأدلة في الغالب على الأجزاء التي تختلف فعلًا: اسم المضيف الذي يجب التوجيه إليه، والمفتاح الذي يجب إنشاؤه، وترويسات الحصة التي ترافق الآن كل استجابة.
كتبنا هذه الأدلة لقارئ محدد: شخص لديه بالفعل كود يعمل مع مزود آخر ويريد ثقة، لا مجرد وعد، بأن توجيهه إلينا سيبقيه يعمل. وهذا يعني أيضًا الوضوح بشأن الأسعار خلال فترة الانتقال. فكل نقطة نهاية وكل مضيف متوافق يكلف السعر نفسه، مع 2,500 طلب مجاني يوميًا من أي عنوان و2,500 طلب مجاني إضافي يوميًا لكل مفتاح، لذا فإن اختبار الترحيل لا يكلف شيئًا قبل أن تلتزم به.
يغطي كل دليل أيضًا التفاصيل الصغيرة التي تميل إلى إرباك الترحيل إذا تُركت دون معالجة: كيف تُحتسب الطلبات المجمّعة، إذ يُحتسب كل عنصر في الاستدعاء المجمّع على حدة وليس الاستدعاء ككل، وما تعنيه ترويسات الحصة الإضافية في كل استجابة إن لم تكن قد رأيتها من قبل. ولا شيء من ذلك يتطلب التخمين بمجرد أن يكون الدليل المناسب مفتوحًا بجانب كودك.
بالنسبة لفريق يفكر في الانتقال، فالمسار الموصى به واضح: اقرأ الدليل الخاص بالمزود الذي تستخدمه حاليًا، وأنشئ مفتاحًا، واختبر عددًا قليلًا من الطلبات الحقيقية على المضيف المتوافق قبل المساس بأي كود في بيئة الإنتاج. ولأن الحصة المجانية تغطي هذا الاختبار بالكامل، فلا تكلفة لمقارنة الاثنين جنبًا إلى جنب قبل اتخاذ القرار.
القائمة الكاملة للمضيفين المتوافقين الذين تغطيهم هذه الأدلة موجودة في /compatibility/، وتوثيق المصادقة وحدود معدل الطلبات العام الذي ينطبق عليهم جميعًا موجود في /docs/authentication/ و/docs/rate-limits/. ونخطط لمواصلة توسيع مجموعة الأدلة هذه مع نمو تغطية التوافق.