اختبار API السفر في بيئة Sandbox: ما لن تكشفه لك

اجتاز الربط كل ما وضعناه أمامه في اختبار API السفر داخل بيئة Sandbox. البحث يعيد رحلات، واستعلام توفر الفنادق يعيد غرفًا، واستدعاء الحجز يعيد رقم تأكيد في كل مرة، ووقّع فريق ضمان الجودة على الإطلاق يوم الخميس. وفي الثلاثاء التالي دفع عميل ثمن فندق بسعر وأكّده المورّد بسعر آخر، وانتهت مهلة حجز طيران دون أن يعرف أحد هل حُجز المقعد أم لا، وأمضى موظف الدعم بعد الظهر كله يطابق سجلّين يصفان الرحلة نفسها. لم يكن شيء من ذلك خطأً فات مجموعة الاختبارات؛ كان سيناريو لم تكن لديها أصلًا وسيلة لرؤيته. بيئة الاختبار ضرورية، لكنها بعيدة جدًا عن الكفاية، وفي المسافة بين الأمرين تقع أغلب الحوادث المكلفة في أي ربط مع موردي السفر.
هذه خطة اختبار موجّهة إلى المطوّر المسؤول عن ذلك الربط: ما الذي تستطيع بيئة الاختبار إثباته، وما الذي لا تستطيعه بحكم طبيعتها، وكيف تغطي الفرق دون أن تحجز مقاعد حقيقية على بطاقة الشركة.
لماذا ينجح الكود في Sandbox ثم ينكسر في الإنتاج
بيئة الاختبار وعدٌ بشكل الاستجابات لا بسلوكها. المخطط (schema) مطابق للإنتاج، أما السلوك فنادرًا ما يطابقه، ولأسباب ليست خطأ أحد: بيئة الاختبار لا تتحمّل تشغيل مخزون حيّ، فتقدّم مجموعة ثابتة من الأسعار والغرف لا تنفد ولا يتغيّر سعرها ولا يتبدّل جدولها. وهي تجيب بسرعة لأن أحدًا غيرك لا يستخدمها، ونادرًا ما تفشل في منتصف العملية.
الإنتاج يفعل كل ذلك يوميًا. المخزون مشترك مع كل بائع آخر، والأسعار مخزّنة مؤقتًا لدى طرف ما في السلسلة فتتقادم، ونظام المورّد تحت الضغط يجيب ببطء أو لا يجيب. الكود الذي لم يرَ سوى Sandbox اختُبر عمليًا أمام مورّد يعيش يومًا مثاليًا.
لذلك تعامل مع بيئة الاختبار على أنها طبقة واحدة من ثلاث: هي تثبت أن طلباتك سليمة وأن المحلّل يفهم المخطط؛ والاستجابات المسجّلة (fixtures) تثبت أن كودك يصمد أمام ما يرسله الإنتاج فعلًا؛ ومجموعة صغيرة مقصودة من الفحوص الحيّة تثبت سلامة التوصيلات بعد أي تغيير. كل طبقة تلتقط ما تعجز عنه الأخريان.
السيناريوهات التي لا تمنحك إياها بيئة الاختبار عادةً
اكتبها قبل أن تكتب أول اختبار. قد تحاكي بيئة الاختبار واحدًا أو اثنين منها بقيمة اختبار خاصة، أما أغلبها فغير موجود فيها ببساطة.
| السيناريو | ما يحدث في الإنتاج | كيف تغطيه |
|---|---|---|
| تغيّر السعر بين البحث والحجز | ينجح الحجز بإجمالي مختلف، أو يفشل بخطأ تغيّر سعر يجب أن تعرضه للعميل | زوج من الاستجابات: نتيجة بحث ونتيجة حجز بإجمالي مختلف؛ تحقّق من أن المسافر يُسأل من جديد ولا يُخصم منه بصمت |
| نفاد المخزون بين التوفر والحجز | الغرفة أو درجة السعر المعروضة لم تعد متاحة لحظة الحجز | استجابة النفاد الحقيقية من المورّد؛ تحقّق من أن المسافر يعود إلى النتائج لا إلى صفحة خطأ |
| انتهاء المهلة في استدعاء الحجز | ربما أنشأ المورّد الحجز وربما لم يفعل | احقن انتهاء مهلة بعد إرسال الطلب؛ تحقّق من الاستعلام عن حالة الحجز قبل أي إعادة محاولة |
| الإرسال المكرّر | نقرة مزدوجة أو إعادة محاولة من العميل تنشئ حجزين | أرسل الحجز نفسه مرتين بمفتاح idempotency واحد؛ تحقّق من وجود حجز واحد فقط |
| تغيير الجدول بعد إصدار التذكرة | الرحلة التي بعتها تقلع في وقت آخر أو برقم رحلة آخر | استجابة لمسار معدَّل؛ تحقّق من وصول التغيير إلى من يملك العلاقة مع العميل |
| نجاح جزئي في حجز متعدد العناصر | يتأكد الطيران ولا يتأكد الفندق | استجابة مختلطة؛ تحقّق من أن النظام يسجّل ما تأكّد بالضبط وينبّه موظفًا |
| تقييد المعدّل تحت الضغط | ردود rate limit ثم إجابات بطيئة | أعد تشغيل ردّ تقييد مسجّل؛ تحقّق من التراجع التدريجي وأن البحث يتباطأ ولا ينهار |
قد تختلف مع العمود الأخير بحسب بنيتك التقنية، ولا بأس. المهم أن يكون لكل صف مسؤول وشرط تحقّق، لأن كل واحد منها سيحدث لك يومًا ما.
ابنِ بيانات الاختبار من استجابات حقيقية لا مخترعة
أنفع عادة في أي ربط مع موردي السفر أن تحتفظ بالاستجابات التي فاجأتك. البيانات الوهمية المكتوبة باليد تعكس ما تظن أن المورّد يرسله، والاستجابة المسجّلة تعكس ما أرسله فعلًا: الحقول الفارغة التي تقول الوثائق إنها لا تفرغ أبدًا، والسعر بعملة لم تطلبها، والخطأ الذي يصل مع حالة نجاح.
روتين عملي:
- سجّل عند الحدود. احفظ نصوص الطلبات والاستجابات الخام لاستدعاءات الموردين في بيئة غير إنتاجية، وفي الإنتاج لعيّنة من الحركة إن سمحت سياسة الخصوصية لديك.
- نظّف قبل أن تحفظ. أسماء المسافرين وأرقام الجوازات والبريد والهواتف ومراجع الدفع تُحذف قبل أن يدخل الملف المستودع، وتُستبدل بقيم وهمية واضحة حتى لا يظنها أحد حجزًا حقيقيًا.
- سمِّ الملفات بالسلوك.
hotel-book-price-increased.jsonيخبر المطوّر التالي لماذا وُجد الملف، أماresponse-17.jsonفلا يخبره بشيء. - احتفظ بالقبيح منها إلى الأبد. الاستجابة المشوّهة التي أوقفت البحث ذات أحد هي أثمن ملف تملكه، ومكانها اختبار يعمل مع كل commit.
ثم اكتب اختبارات عقد (contract tests) على هذه الملفات: المحلّل، والتحويل إلى نماذجك الداخلية، وتصنيف الأخطاء. إن غيّر المورّد اسم حقل وفشل اختبار العقد، عرفت ذلك في CI لا من عميل غاضب. وقد تناولنا جانب تصنيف الأخطاء بتفصيل أكبر في مقالنا عن معالجة أخطاء API محرك الحجز.
اختبار مسارات المال دون إنفاق المال
هنا تحديدًا تقلّ فائدة Sandbox، لأن مسارات المال هي بالضبط حيث تختلف بيئة الاختبار عن الحقيقية. إصدار التذاكر الفعلي، وتحصيل البطاقة الفعلي، وفواتير الموردين الفعلية، هي أكثر ما تحتاج أن يكون صحيحًا وأقل ما يمكنك التدرّب عليه حيًّا.
قسّم المشكلة. حسابات التسعير منطق خالص يمكن اختباره بالكامل دون اتصال: خذ أسعارًا مسجّلة، وطبّق قواعد هامش الربح وتحويل العملة والتقريب، وتحقّق من الإجمالي الذي يراه المسافر. افعل ذلك للحالات المحرجة: سعر بالدولار يُباع بالريال أو الدرهم، وهامش ربح نسبي على منتج وثابت على آخر، وسعر طفل، وخطوة تقريب تختلف بين العرض والتحصيل. الإجمالي الخاطئ ببضعة دراهم يبقى خاطئًا، وهو خاطئ في كل حجز.
النصف الثاني هو انتقالات الحالة حول الدفع. صُغها صراحةً: معروض، محجوز مؤقتًا، مدفوع، مؤكَّد، صادرة تذكرته، ملغى، مستردّ. واختبر أن لكل انتقال سببًا واحدًا فقط. الاختبار الذي يلتقط أغلى خطأ هو الذي يتحقّق من أنه لا يمكن تحصيل دفعة لحجز لم يؤكده المورّد، ولا يمكن أن يوجد حجز مؤكَّد دون سجل دفع.
وأخيرًا، اجعل وصول أي تشغيل اختباري إلى الإصدار الحي مستحيلًا. لا نقول غير مرجّح، بل مستحيل. فحص عند بدء التشغيل يرفض تشغيل الاختبارات إذا حُمّلت بيانات اعتماد الإنتاج يكلّف سطرًا واحدًا، ويجنّب فريقك أسوأ صباح يمكن أن يمرّ به.
كم يكلّفك الخطأ هنا
السيناريو الفائت في ربط السفر نادرًا ما يظهر كخطأ؛ يظهر كحجز يبدو سليمًا. تذكرة مكرّرة لم يطلبها أحد، وعلى أحدهم إلغاؤها (void) قبل انتهاء المهلة. فندق تأكّد بسعر صار على الوكالة أن تتحمّله. حجز انتهت مهلته فأعاد النظام المحاولة، فإذا بالمورّد يحجز غرفتين ويرسل فاتورتين. وفي تذكرة طيران تُباع عبر وكالة، قد يعود عدم التطابق بين ما صدر وما بيع لاحقًا على شكل ADM، بعد أن يكون هامش الربح من تلك البيعة قد أُنفق منذ زمن.
هذه التكاليف تقع على الشركة التي باعت الرحلة، لا على المطوّر الذي كتب حلقة إعادة المحاولة. وهذه هي الحجة كلها لاختبارها قبل الإطلاق بدل تعلّمها تذكرة دعم بعد أخرى.
ما تفحصه سريعًا بعد كل تغيير لدى المورّد
الموردون يغيّرون: إصدار API جديد، نقطة نهاية جديدة، بيانات اعتماد مُدوَّرة، ربط محتوى مختلف. وربما لم يتغيّر في كودك سطر واحد. شغّل هذه القائمة رغم ذلك، في البيئة التي تتحدث إلى المورّد المتغيّر:
- بحث واحد لكل منتج تبيعه من هذا المورّد، على مسار أو مدينة تعرف أنها تعيد نتائج، مثل الرياض–دبي.
- حلّل كل النتائج دون إسقاط أي منها بصمت، وقارن عددها بما في الاستجابة الخام.
- سعّر نتيجة واحدة من البداية إلى النهاية، وقارن الإجمالي المعروض بحسابك أنت من السعر الخام.
- أنشئ حجزًا في بيئة الاختبار، ثم اقرأ حالته وقارن كل حقل تخزّنه.
- ألغِه وتأكد أن الإلغاء ظاهر في سجلاتك وعند المورّد معًا.
- أعد تشغيل ملفاتك القبيحة المحفوظة عبر المحلّل الجديد.
- تأكد أن انتهاء المهلة وتقييد المعدّل ما زالا يقودان إلى السلوك الذي قرّرته، فالإصدار الجديد قد يردّ عليهما بشكل مختلف. وإن تغيّرت أزمنة الاستجابة، فإن مقالنا عن زمن الاستجابة يشرح أي جزء منها يقع في يدك.
قصيرة بما يكفي لتشغيلها كل مرة، وهذا هو المقصود. فحص سريع لا يشغّله أحد لأنه يستغرق يومًا ليس فحصًا سريعًا.
أين يقع Sandbox من كل هذا
لا شيء مما سبق يقلّل من فائدة بيئة الاختبار؛ بل يضعها في مكانها الصحيح: المكان الذي تتعلّم فيه المخطط وتتأكد فيه من صحة الطلبات، قبل أن تتولّى الملفات المسجّلة والفحوص الحيّة ما لا تصل إليه. إن كنت تقيّم واجهات API الطيران والفنادق في المنصة، فالوصول يبدأ بمحادثة لا بمفتاح تحصل عليه بنفسك، فاحمل خطة الاختبار هذه إلى تلك المحادثة واسأل كيف يُغطّى كل صف في الجدول أعلاه. الإجابات ستخبرك عن أي API أكثر مما تخبرك وثائقه.