انتقل إلى المحتوى
المدونة

ربط API حجز الطيران: ما لا تقوله الوثائق

تحرير Tekravel
كُتب بمساعدة الذكاء الاصطناعي

المهمة على لوحة الفريق تقول ببساطة: "أضف الطيران". سبق لك أن ربطت بوابة دفع، وربما خدمة شحن أو خرائط، والنموذج الذهني الذي تحمله واضح: بحث، ثم عرض النتائج، ثم أخذ البطاقة، وانتهى الأمر. ثم يعود أول حجز حقيقي بسعر يختلف عن سعر صفحة النتائج، وتنتهي مهلة الحجز الثاني دون أن يستطيع أحد إخبارك هل للعميل مقعد أم لا، ويسألك أحد فريق العمليات لماذا يوجد حجز بلا تذكرة. ربط API حجز الطيران يبدو من الخارج مثل صفحة دفع في متجر إلكتروني، لكنه في العمق معاملة موزَّعة على أنظمة صُممت قبل REST بزمن طويل، ومعظم المفاجآت تأتي من هذه الفجوة.

هذا المقال موجَّه إلى المطوّر الذي لم يرَ PNR في حياته. وهو لا يتحدث عن نقاط نهاية مورد بعينه؛ فالأسماء تتغير من مزوّد لآخر، أما الشكل فلا يتغير.

تسلسل الطلبات في ربط API حجز الطيران

كل API طيران تقريباً، أياً كانت أسماء دواله، يمر بالخطوات الأربع نفسها. وضبط الحدود بينها هو معظم العمل.

الخطوةما تعيدهما يجب أن تحفظهما الذي يتعطل
البحثمسارات بسعر ومفتاح عرض أو مفتاح سعر غير مفهوملا شيء دائم — النتائج تتقادم بسرعةتعامل السعر كأنه نهائي؛ وينتهي المفتاح قبل الدفع
التسعير / التحققالسعر المؤكد، وقواعد الأجرة، والأمتعة، وأحياناً حقول المسافرين المطلوبةالعرض المُتحقَّق منه وموعد انتهائهتغيّر السعر؛ نفدت الدرجة؛ القواعد تختلف عمّا عرضته
الحجزحجز — أي PNR — برمز حجز وموعد نهائي للإصدارمرجعك الخاص، ورمز الحجز، والموعد النهائي، وبيانات المسافرين كما أُرسلت حرفياًانتهاء المهلة بلا جواب؛ PNR مكرر؛ أسماء مرفوضة
الإصدارأرقام التذاكر الإلكترونية؛ وهنا يُلتزم بالمال فعلاًكل رقم تذكرة مربوطاً بالمسافر والقطاع الذي يخصّهإصدار جزئي؛ إلغاء الحجز من شركة الطيران لأن الموعد النهائي فات

الصف الذي يجادل فيه الناس هو الثالث، لأن كثيراً من الواجهات تتيح الحجز والإصدار في طلب واحد. استخدمه إن شئت. لكن الأمرين يبقيان منفصلين في عالم شركات الطيران: يمكن أن يوجد PNR بلا تذكرة، ويمكن أن يفشل الإصدار بعد إنشاء الـPNR. نقطة النهاية المدمجة تخفي فقط اللحظة التي نجح فيها أحدهما وفشل الآخر، ولذلك يجب أن يبقى في نموذج بياناتك مكان لهذه الحالة.

ولاحظ ما لا يعيده البحث: الوعد. البحث إعلان. خطوة التسعير هي عرض السعر، والتذكرة وحدها هي البيع.

لماذا لا يكون سعر البحث هو سعر الحجز

مطوّر الويب يتوقع كتالوجاً، ومخزون شركات الطيران ليس كذلك. الرحلة تُباع في درجات حجز، كل درجة منها سلة مقاعد بسعر معيّن، وشركة الطيران تفتح هذه السلال وتغلقها باستمرار مع امتلاء الرحلة. تُجمَع نتائج البحث بسرعة من بيانات توافر قد تكون متأخرة قليلاً أصلاً؛ وحين ينتهي المستخدم من إدخال جوازَي سفر قد تكون أرخص سلة على تلك الرحلة قد أُغلقت. وحين تعمل خطوة التسعير تسأل من جديد، والجواب الصادق يكون أحياناً أعلى.

وللضرائب انحرافها الخاص. فهي تُحسب من جديد عند التسعير للمسافرين والمسار بدقة، والطفل أو الرضيع يُسعَّر بطريقة تختلف عن البالغ الذي افترضه البحث. وإن كانت واجهتك تعرض عملة غير العملة التي يسعّر بها المورد، فتحويل العملة موضع إضافي يتحرك فيه الرقم.

والنتيجة التصميمية بسيطة وكثيراً ما تُتجاهل: لا تخصم أبداً على سعر البحث. شغّل خطوة التسعير قبل الدفع، وقارن، وإن تغيّر المبلغ فاعرض الرقم الجديد واسأل المستخدم. وأي هامش ربح تضيفه يجب أن يُعاد حسابه على الأجرة المُعاد تسعيرها، لا أن يُنقل من صفحة النتائج — وهو المنطق نفسه الذي تمر به الوكالة عند ضبط هامش الربح أونلاين، وينكسر بالطريقة نفسها حين يتحرك الأساس تحته.

Idempotency، وماذا تعني انتهاء المهلة أثناء الحجز

هذا القسم يستحق القراءة مرتين.

حين تنتهي مهلة طلب الحجز فأنت لا تعرف ما الذي حدث. ربما لم يصل الطلب أصلاً. وربما وصل وفشل. أو — وهذه الحالة المؤلمة — وصل، وأنشأ المورد الـPNR لدى شركة الطيران، ثم ضاع الرد في طريق عودته إليك. بالنسبة لشيفرتك، الحالات الثلاث متطابقة. وبالنسبة لشركة الطيران، الحالة الثالثة حجز حيّ يحتجز مقاعد باسم عميلك.

ردّ الفعل المعتاد من عمليات الربط الأخرى هو إعادة المحاولة. وهنا قد تُنتج إعادة المحاولة العمياء PNR ثانياً للمسافرين أنفسهم على الرحلة نفسها. شركات الطيران تعامل الحجوزات المكررة على أنها مخالفة لسياساتها؛ وبحسب الناقل واتفاقيات الوكالة، تتراوح العاقبة بين الإلغاء التلقائي لأحد الحجزين أو كليهما، ومذكرة خصم — ADM — تُرسل إلى الجهة التي أصدرتهما. والوكالة التي تتسلمها ستريد أن تعرف لماذا حجز نظامك مرتين.

ما ينجح، بهذا الترتيب تقريباً:

  • أنشئ مرجع الحجز الخاص بك قبل الاتصال بالمورد، واحفظه، وأرسله مع الطلب حيثما يقبل الـAPI مرجعاً من العميل. وإن كان يدعم مفتاح idempotency فاستخدمه؛ وإن لم يدعمه، فمرجعك هو ما يتيح لك البحث عن الحجز لاحقاً.
  • اجعل الحالة المجهولة صريحة في النموذج. قيد الانتظار، مؤكَّد، فاشل — ومجهول. انتهاء المهلة ينقل الحجز إلى "مجهول"، لا إلى "فاشل".
  • احسم المجهول بالسؤال لا بالتكرار. استرجع الحجز بمرجعك، أو اعرض الحجوزات الأخيرة لهؤلاء المسافرين، قبل أن تقرر المحاولة من جديد.
  • شغّل مهمة تسوية دورية تمر على كل ما بقي مجهولاً وتقارنه بما يُبلغ عنه المورد، وحوّل ما لا تستطيع حسمه إلى طابور بشري بدل التخمين.

انتهاء المهلة عند الإصدار هو المشكلة نفسها ومعها المال. إن خصمت من البطاقة قبل الإصدار ثم تعلّق الإصدار، فلديك عميل دفع وربما بلا تذكرة. وإن أصدرت قبل الخصم ثم فشل الخصم، فقد أصدرت مستنداً على أحدٍ أن يدفع ثمنه لشركة الطيران. الشكل الشائع هو تفويض البطاقة أولاً، ثم الإصدار، ثم تحصيل المبلغ عند النجاح — والمهم أن تقرر ذلك عن قصد، لا أن تكتشفه في بيئة الإنتاج.

مفاهيم السفر التي تفاجئ مطوّري الويب

لا شيء من هذه صعب. لكن كلاً منها كلّف أحدهم أسبوعاً لأنه لم يكن يعرف بوجوده.

الـPNR ليس تذكرة

الـPNR هو سجل الحجز: المسافرون، والقطاعات، وبيانات التواصل، وموعد نهائي. أما التذكرة فهي المستند المدفوع الذي يخوّل المسافر الصعود إلى الطائرة. الـPNR غير المُصدَر ينتهي عند موعد الإصدار النهائي وتعود المقاعد إلى البيع، وأحياناً دون أن تلاحظ ذلك من جهتك.

الأسماء شبه ثابتة

بعد الإصدار، معظم الأجور لا تسمح بتغيير الاسم إلا بتصحيح بسيط، وما يُعد بسيطاً يختلف من شركة طيران لأخرى. ويجب أن يطابق الاسم وثيقة السفر. اجمع اسم العائلة والاسم الأول منفصلين، ولا تدع لقباً حراً يتسرب إلى حقل الاسم، وتحقق من البيانات قبل طلب الحجز لا بعده.

أنواع المسافرين تُسعَّر، وليست للزينة

البالغ والطفل والرضيع أنواع أجرة، والعمر الذي يحدد النوع عادةً هو العمر في تاريخ السفر لا في تاريخ الحجز. والرضيع في حضن مرافقه لا يشغل مقعداً في الغالب، ولا يسافر إلا مع بالغ. أخطئ في النوع، وستفشل خطوة التسعير أو تعطيك الأجرة الخطأ.

الأوقات محلية، والقطاع غير المرحلة

أوقات الإقلاع والوصول تُعطى بالتوقيت المحلي لكل مطار. لا تحوّلها إلى المنطقة الزمنية للمستخدم عند العرض، ولا تحسب المدة بطرح أحدهما من الآخر دون فارق التوقيت. الرحلة تتكون من قطاعات؛ والقطاع الذي فيه توقف فني يتكون من أكثر من مرحلة. يجب أن تتفق واجهتك وبياناتك على أيٍّ منها هو "التوقف".

أشياء تحدث بعد البيع

شركات الطيران تغيّر الجداول بعد إصدار التذاكر. حجز كان صحيحاً عند الإصدار قد يظهر بعد أسابيع بموعد جديد أو رقم رحلة جديد أو وصلة منقطعة، وبحسب المورد تعرف ذلك عبر إشعار، أو طابور، أو باسترجاع الحجز من جديد. خطط لأن يتغير الحجز بعد أن تكون قد توقفت عن النظر إليه.

الإلغاء الفوري (Void) ليس استرداداً

بعد الإصدار بقليل توجد عادةً نافذة يمكن فيها إبطال التذكرة كأنها لم تكن. بعد تلك النافذة لا يبقى إلا الاسترداد وفق قواعد الأجرة، وقد يكلّف غرامة أو لا يعيد شيئاً على الإطلاق. النافذة وقواعدها ملك للمورد ولاتفاقية الإصدار؛ اقرأها قبل أن تبني زر "إلغاء".

كم يكلّفك الخطأ

أعطال ربط الطيران مكلفة بطريقة محددة: إنها تقع على الناس لا على السجلات. الحجز المكرر يتحول إلى مكالمة مع شركة الطيران وربما مذكرة على حساب الوكالة. والعميل الذي دفع بلا تذكرة يتحول إلى استرداد وشكوى وخطر نزاع على البطاقة. والتذكرة الصادرة دون دفع ناجح تتحول إلى دين لشركة الطيران على أحدٍ أن يسدده. وتغيير الجدول الذي لم يعالجه أحد يتحول إلى مسافر في المطار لرحلة غادرت قبل موعده.

لا شيء من ذلك يظهر في اختبار المسار السعيد. اكتب المسارات التعيسة أولاً: انتهاء المهلة أثناء الحجز، والسعر الذي ارتفع، والتذكرة التي فشلت بعد الـPNR، والإلغاء بعد دفع ناجح. إن عالجت هذه، فالمسار السعيد هو الجزء السهل.

الاختبار على API طيران

بيئات الاختبار لدى الموردين مفيدة لكنها ناقصة. تكون عادةً أهدأ من الإنتاج، فنفاد الدرجات وتغيّر الأسعار أندر فيها، وبعضها لا يحاكي انتهاء المهلة أصلاً. استخدمها لشكل الطلبات ورسائل التحقق، ثم خطط لتشغيل مضبوط في الإنتاج بحجوزات حقيقية تلغيها إلغاءً فورياً داخل النافذة — مع علم فريق العمليات بما تفعله.

أما هل تربط أصلاً فسؤال آخر. إن كان ما تحتاجه فعلاً واجهة حجز لا مخزوناً خاماً داخل نظامك، فالمفاضلة مشروحة في بناء محرك حجز خاص أم منصة وايت ليبل، والمنطق نفسه ينطبق على منصة B2B للوكلاء الفرعيين. وإن أردت المخزون داخل شيفرتك أنت، فهذه المنصة توفّر واجهات API للطيران والفنادق، ويبدأ الوصول إليها بحوار حول حالة الاستخدام لديك لا بمفتاح ذاتي الخدمة — وهي أيضاً اللحظة المناسبة لطرح كل سؤال من الأسئلة أعلاه.

تحرير Tekravel

قسم تقنيات السفر

يكتب قسم تقنيات السفر في Tekravel لأهل المهنة: أصحاب الوكالات، والمجمّعين، والمطوّرين الذين يربطون أنظمتهم بها. تُراجَع كل مقالة أمام المنصة التي تصفها قبل نشرها.