ربط API لحجوزات الطيران والفنادق: رحلة واحدة وحجزان

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