معالجة أخطاء API في محرك الحجز: ثلاثة إخفاقات تكلّف مالاً

تصل تذكرة الدعم مساء الخميس. عميل دفع، ودارت الصفحة، ثم ظهرت رسالة خطأ عامة. البطاقة خُصم منها المبلغ. وسجلاتك تُظهر طلب POST أُرسل إلى المورد ولم يعد منه أي رد. هل حجزت شركة الطيران المقعد؟ لا أحد يعرف، والعميل ينتظر. إن معالجة أخطاء API في محرك الحجز الجيدة هي في معظمها عمل يمنعك من الوصول إلى هذا الموقف أصلاً، أو على الأقل يجعلك تعرف بالضبط ما تفعله حين تصل إليه.
تتعامل أغلب أدلة الربط مع الأخطاء كأنها قائمة بأرقام الحالة. في الحجز، الأرقام هي الجزء السهل. الذي يكلّف مالاً هو مجموعة صغيرة من المواقف يبدو فيها الطلب كأنه فشل لكن الواقع تغيّر رغم ذلك، أو يبدو كأنه نجح ولم يتغيّر شيء. ثلاثة منها أهم من البقية.
الفشل الأول: تغيّر السعر بين البحث والحجز
نتائج البحث عرض سعر وليست عقداً. الأسعار مخزّنة مؤقتاً، والمخزون مشترك بين كل القنوات التي يبيع عبرها المورد، والرقم الذي عرضته قبل دقائق قد يكون قديماً الآن. يخبرك المورد بذلك عند خطوة إنشاء الحجز، أحياناً برد صريح بأن «السعر تغيّر»، وأحياناً بإرجاع إجمالي مختلف بهدوء داخل رد ناجح في ظاهره.
النوع الثاني هو الخطر. إذا قرأ كودك التأكيد وحفظ الحجز وخصم من العميل المبلغ الذي رآه، فإن الفرق يخرج من هامش ربحك، أو لاحقاً من ADM. لذلك القاعدة بسيطة: قارن الإجمالي الذي أكده المورد بالإجمالي الذي وافق عليه العميل، في كل مرة، برمجياً، قبل أن تسحب الدفعة.
ما تفعله عند الاختلاف يتوقف على حجم الفارق ومن يتحمله. كسور صغيرة من التقريب بين العملات حدّ تضبطه مرة واحدة. أما أي فارق أكبر فيعود إلى العميل بسعر جديد وزر موافقة صريح. لا تمتصه تلقائياً ولا تحصّله تلقائياً.
الفشل الثاني: حجز تم لكن التذكرة لم تصدر
وجود PNR لا يعني وجود تذكرة. كثير من المسارات تنشئ الحجز أولاً ثم تصدر التذكرة الإلكترونية في خطوة منفصلة، وبينهما مهلة زمنية. إذا نجح الدفع وفشل الإصدار، فأنت تحتفظ بأموال العميل وبحجز سينتهي في موعده هو.
نادراً ما يكون هذا الفشل صاخباً. يرجع طلب الإصدار بخطأ أو بانتهاء مهلة، ويبقى الحجز في حالة تسميها قاعدة بياناتك «مدفوع» بينما يقول المورد «محجوز». وفي الأثناء تجري مهلة الإصدار، وشركة الطيران لا تنتظر كما تنتظر قائمة الدعم لديك.
عالجه بوصفه حالة مستقلة، لا نسخة من النجاح ولا من الفشل. يحتاج الحجز إلى هذه الحالات على الأقل: منشأ، محجوز، الدفع مسحوب، قيد الإصدار، مُصدَر، فاشل وقابل للاسترداد. وحالة «الدفع مسحوب، قيد الإصدار» هي التي تحتاج إلى مؤقّت: إذا بقي حجز فيها طويلاً، يجب أن تعيد مهمة آلية قراءة الحجز من المورد وتقرر، لا أن تنتظر أن ينتبه إنسان. القرار رخيص حين تعرف مهلة المورد، لأنها تخبرك كم يمكنك إعادة المحاولة بأمان قبل أن يلزم الاسترداد.
الفشل الثالث: انتهاء المهلة ونتيجة مجهولة
هذه هي تذكرة مساء الخميس. طلبك خرج، ولم يعد رد، وانقطع الاتصال أو استسلمت البوابة. ربما عالجه المورد كاملاً، أو جزئياً، أو لم يعالجه أبداً.
الإغراء هو إعادة المحاولة. لا تعد طلب إنشاء الحجز بشكل أعمى، لأن المحاولة الثانية قد تنتج حجزاً ثانياً، والتكرار كلفة حقيقية: مقعدان محجوزان، وربما تذكرتان صادرتان، ونزاع استرداد على إحداهما.
الترتيب الآمن: توقف، ثم اقرأ، ثم قرر. أوقف مسار العميل بحالة صادقة مثل «نؤكد حجزك الآن». اقرأ جانب المورد بالبحث عن الحجز بالمرجع الذي أنشأته قبل الاتصال (ولهذا تنشئ مرجعاً خاصاً بك أولاً وترسله مع الطلب إن قبله المورد). بعد ذلك فقط قرر: إذا وُجد فاستكمل من الحالة الحقيقية؛ وإذا لم يوجد بعد انقضاء نافذة المعالجة لدى المورد فمن الآمن إعادة المحاولة مرة واحدة.
وإذا لم يتح لك المورد البحث بمرجعك، فابحث باسم المسافر والمسار والتاريخ ضمن نافذة ضيقة، واعتبر أي تطابق دليلاً على وجود الحجز. الأمر غير أنيق، لكنه أرخص بكثير من حجز مكرر.
جدول قرارات يمكنك أن تعترض عليه
| ما تراه | ما تعرفه | ما تفعله | ما لا تفعله |
|---|---|---|---|
| المورد يرد بأن السعر تغيّر | لم يُنشأ أي حجز | اعرض الإجمالي الجديد، اطلب الموافقة، أعد الإنشاء | إعادة الإرسال بالسعر القديم على أمل أن يمر |
| نجاح، لكن الإجمالي يختلف عما وافق عليه العميل | الحجز موجود بالسعر الجديد | علّق الدفع، اسأل العميل، ألغِ الحجز إن رفض | سحب المبلغ القديم وتحمّل الفرق |
| الدفع مسحوب وطلب الإصدار يفشل | PNR موجود وحالة التذكرة مجهولة | أعد قراءة الحجز، أعد الإصدار ضمن المهلة، واسترد بعدها | وسم الحجز فاشلاً ونسيان الـ PNR |
| انتهاء مهلة عند الإنشاء | النتيجة مجهولة | ابحث بمرجعك ثم أكمل أو أعد المحاولة مرة واحدة | إعادة فورية عمياء |
| انتهاء مهلة عند الإلغاء | قد تبقى مسؤولاً عن القطعة | أعد قراءة الحالة قبل أن تقول للعميل أي شيء | عرض «ملغى» لأن النقرة حدثت |
صف قد تعترض عليه: بعض الفرق ترد المبلغ عند أول خطأ إصدار لتهدئة العميل. هذا مقبول في التذاكر الرخيصة وعادة سيئة في الغالية، إذ قد تخسر سعراً كان يمكن إنقاذه بعد دقيقة.
كم يكلّفك الخطأ هنا
لكل فشل فاتورة مختلفة. تغيّر سعر فاتك يعني هامشاً ضائعاً في كل حجز يمسّه، وغالباً لا يُلاحظ حتى المطابقة. وحجز بلا تذكرة يعني عميلاً يصل إلى المطار بحجز انتهى وبمبلغ مخصوم من بطاقته، أي اعتراضاً على الدفع ومشكلة سمعة معاً. وإعادة عمياء بعد انتهاء المهلة تعني حجزاً مكرراً، وشركات الطيران تدقق في المكرر؛ ونمطه المتكرر هو ما ينتهي في ADM.
لا شيء من هذا غريب. إنها السباكة غير اللامعة التي تفصل العرض التجريبي عن شيء يمكنك تركه يعمل طوال عطلة نهاية الأسبوع.
ابنِ مهمة المطابقة قبل أن تحتاجها
تنتهي الإخفاقات الثلاثة بالطريقة نفسها: قاعدة بياناتك وقاعدة المورد لا تتفقان. فاكتب المهمة التي تقارن بينهما قبل أول حادثة لا بعدها. تشغيل ليلي هو الحد الأدنى؛ وكل بضع دقائق لما هو في حالة انتقالية أفضل. تسرد المهمة الحجوزات العالقة في «محجوز» أو «قيد الإصدار» أو «مجهول»، وتسأل المورد عن رأيه، ثم تصلح السجل أو تفتح تذكرة مرفقاً بها الدليل.
احتفظ بكل طلب ورد لمكالمات الحجز، بما فيها حالات انتهاء المهلة، مع المرجع الذي أرسلته. حين يعترض عميل على خصم، هذا السجل هو حجتك. وهو يجعل نقاش زمن الاستجابة صادقاً أيضاً: اقرأ ما يمكنك وما لا يمكنك إصلاحه في زمن استجابة API لتفهم لماذا انتهاء المهلة واقع لا خلل يُستأصل.
وإذا كنت ما تزال تقرر كيف تربط المورد نفسه، فإن الشرح في ربط API حجز الطيران يغطي ترتيب الطلبات الذي يفترضه هذا المقال. وإن أردت مناقشة كيف تقابل هذه الحالات واجهات API للطيران والفنادق لدينا، فالوصول يبدأ بحوار: اطّلع على صفحة واجهات السفر.