مقارنة API السفر: قيّم المحاور لا أسماء المزوّدين

أمامك ثلاثة عروض تقديمية من ثلاثة مزوّدين، كلٌّ في تبويب. في كل عرض شريحة بقائمة طويلة من شركات الطيران، وشريحة بعدد الفنادق، وبيئة تجريبية (Sandbox)، وREST وJSON، وبريد للدعم الفني. تبني جدولاً، وتضع علامة صح في كل خانة، فينتهي الجدول بالتعادل. هكذا تنتهي عادةً أي مقارنة بين مزوّدي API للسفر حين تُبنى على قائمة ميزات، وهي نهاية خاطئة؛ لأن الفروق التي ستحسم عامك القادم لا تظهر إلا بعد الإطلاق: في الحجز الذي نجح عند المورد وانتهت مهلته عندك، وفي الاسترداد الذي لا يستطيع أحد تنفيذه، وفي شركة الطيران التي كانت في القائمة ثم تبيّن أن إصدار تذاكرها غير ممكن عبر هذا المسار.
هذا المقال موجّه إلى المطوّر أو المسؤول التقني الذي سيتخذ القرار ويدافع عنه لاحقاً. لا نرتّب فيه المزوّدين. نقدّم محاور للمقارنة، وخطة تجربة تقضي وقتها في حالات الفشل، وأسئلة قليلة تكشف بسرعة إن كنت تتحدث مع مورد حقيقي أم مع وسيط يعيد بيع مورد آخر.
لماذا تنتهي قائمة الميزات دائماً بالتعادل
قائمة الميزات تسأل: هل القدرة موجودة؟ وكل واجهة API للسفر تقريباً تجيب بنعم عن كل سطر تقريباً، لأن الأسطر مكتوبة بلغة الصفحة التسويقية: بحث، تسعير، حجز، إلغاء، إصدار، Webhooks، بيئة تجريبية. السؤال الذي يفرّق بينها ليس وجود cancel، بل ما يحدث حين تستدعيه على حجز صدرت تذكرته قبل الإقلاع باثنتي عشرة ساعة، على سعر فيه غرامة، عبر مسار جاء محتواه من طرف ثالث. لا توجد خانة لذلك في القائمة.
وهناك مشكلة ثانية: من يملأ القائمة غالباً هو المزوّد نفسه. أنت تقيّم وصفه لنفسه.
مقارنة API السفر على محاور لا على أسماء المزوّدين
استبدل جدول «المزوّد مقابل الميزة» بمحاور تقيّمها أنت، من أدلة جمعتها خلال التجربة. الجدول أدناه هو ما نستخدمه نحن. قد تعطي الأسطر أوزاناً مختلفة — وكالة تبيع الفنادق فقط يهمها الإصدار أقل — وينبغي أن تجادل فيه قبل أن تعتمده.
| المحور | ما تسأله قائمة الميزات | ما يجب أن تعرفه فعلاً | كيف يبدو الجواب الضعيف |
|---|---|---|---|
| التغطية | كم شركة طيران وكم فندقاً؟ | كم منها يمكن البحث فيه وحجزه وإصداره أو تأكيده عبر هذه الواجهة، في أسواقك أنت | رقم كبير واحد بلا تفصيل |
| العمق | هل توجد نقطة إلغاء؟ | أي إجراءات ما بعد الحجز مؤتمتة لكل مصدر محتوى: الإبطال (Void)، الاسترداد، إعادة الإصدار، تصحيح الاسم، الخدمات الإضافية | «فريق العمليات لدينا يتولى ذلك» |
| سلامة السعر | هل التسعير لحظي؟ | كم مرة يختلف سعر الحجز عن سعر البحث، وكيف تخبرك الواجهة بذلك | «الأسعار دائماً مباشرة» |
| دلالة الأخطاء | هل الأخطاء موثّقة؟ | هل يخبرك الخطأ بحالة الحجز، لا بأن شيئاً ما فشل فحسب | رمز خطأ عام واحد لكل أنواع الفشل |
| عدم تكرار التنفيذ (Idempotency) | — | هل يمكن أن تُنشئ إعادة محاولة الحجز حجزاً ثانياً | صمت، ثم «لم نصادف ذلك» |
| المورد المسجّل | — | عقد مَن، ورقم IATA لمن، وعبر أي BSP تصدر التذكرة | «نعمل مع كل أنظمة GDS الكبرى» |
| الوصول والدعم | هل توجد بيئة تجريبية؟ | من يجيب حين يعلق PNR حقيقي، وبأي سرعة | نموذج تذكرة دعم بلا اسم مسؤول |
سطران من هذه الأسطر لا يقابلهما أي سؤال في قائمة الميزات. ليس ذلك صدفة: إنهما الأكثر كلفة حين يقع الخطأ، والأقل احتمالاً أن يذكرهما عرض المزوّد من تلقاء نفسه.
التغطية ليست عمقاً
قائمة شركات الطيران هي أكثر شرائح العرض تضليلاً. قائمة من مئات الناقلات قد تعني أشياء مختلفة، وواحد منها فقط هو ما تريده.
بعض هذه الناقلات يأتي عبر نظام التوزيع العالمي (GDS) ويمكن حجزه وإصداره من البداية إلى النهاية. وبعضها يأتي عبر اتصالات قدرات التوزيع الجديدة (NDC)، حيث قد يعمل البحث جيداً، لكن خدمات ما بعد الحجز — التعديل، الاسترداد الجزئي، إضافة حقيبة — قد تبقى يدوية لتلك الشركة. وبعضها ناقلات منخفضة التكلفة يُجمَّع محتواها من وسيط آخر؛ تستطيع عرضها، وأحياناً حجزها، ثم تصل التذكرة عبر مسار لا تتحكم فيه، وفي توقيت لا تستطيع أن تعد به عميلك. وبعضها في القائمة لأن سعراً ظهر يوماً ما في نتيجة بحث.
الناقل الذي تستطيع عرضه ولا تستطيع إصدار تذكرته ليس تغطية. وفي منتج للبيع المباشر هو أسوأ من غيابه، لأن العميل يختاره ويدفع ثم ينتظر.
الفنادق لها الشكل نفسه بكلمات أخرى. عدد العقارات يشمل ما ربطه المزوّد (Mapping) وما لم يربطه، وأسعاراً ثابتة خُزّنت الأسبوع الماضي إلى جانب التوفر اللحظي، وغرفاً بنظام الحصص (Allotment) مع فترة تحرير إلى جانب مخزون البيع الحر. اطلب العدد القابل للحجز اللحظي في المدن التي تبيعها، واسأل كيف يدمجون التكرار بين مورديهم؛ فظهور الفندق نفسه ثلاث مرات بثلاثة أسعار تذكرة دعم تنتظر موعدها.
الاختبار العملي ضيّق. اكتب عشرين مساراً وعشرين مدينة فندقية تشكّل معظم مبيعاتك — الرياض–القاهرة، دبي–إسطنبول، جدة–كوالالمبور وما شابهها — واطلب من المزوّد أن يُريك هذه بالذات تعمل كاملة في البيئة التجريبية: بحث، تسعير، حجز، إصدار أو تأكيد، إلغاء. المزوّد الذي يملك العمق سيفعل ذلك دون تردد. والمزوّد الذي يملك الشريحة فقط سيبدأ بالحديث عن الشريحة.
ماذا تختبر في الفترة التجريبية: مسارات الخطأ لا مسارات النجاح
كل بيئة تجريبية تحجز تذكرة اقتصادية ذهاباً فقط على مسار هادئ بنجاح. هذا ما بُنيت لتعرضه. أما حركتك الحقيقية فستقضي جزءاً معتبراً من عمرها في المسارات الأخرى، والفترة التجريبية هي اللحظة الوحيدة الرخيصة لرؤيتها.
استخدمها لتنفيذ هذه القائمة، وسجّل ما أعادته الواجهة إلى جانب ما كان صحيحاً فعلاً بعد ذلك:
- تغيّر السعر بين البحث والحجز. هل يفشل الحجز، أم ينجح بالسعر الجديد، أم يعيد استجابة مميزة تطلب التأكيد؟ وهل تستطيع واجهتك التمييز دون تحليل نص رسالة؟
- عرض منتهي الصلاحية. ابحث، وانتظر أطول من عمر العرض لدى المزوّد، ثم احجز. هل الانتهاء خطأ محدد، أم الخطأ نفسه الذي يعني «المورد متوقف»؟
- نفاد المقاعد عند الحجز. مخزون يختفي بين التسعير والحجز. ما حالة الحجز، وهل يُحرَّر أي تفويض دفع؟
- إعادة المحاولة بعد انتهاء المهلة. أرسل طلب حجز، واقطع الاتصال قبل الرد، ثم أرسله مرة أخرى. هل لديك الآن PNR واحد أم اثنان؟ هذا الاختبار وحده يخبرك عن المزوّد أكثر من بقية التجربة مجتمعة.
- حجز أُنشئ وإصدار فشل. هل تستطيع الواجهة الإبلاغ عن PNR موجود غير مُصدَر، وهل تخبرك بمهلة الإصدار؟
- فشل جزئي. طلب فندقي بعدة غرف تتأكد إحداها ولا تتأكد الأخرى. رحلة ذهاب وعودة يأتي كل اتجاه منها من مصدر مختلف.
- إلغاء خارج فترة الإلغاء المجاني. هل تُعرض الغرامة قبل أن تؤكد، أم تكتشفها في الفاتورة؟
- توقف المورد. اسأل المزوّد كيف تحاكي ذلك. إن لم يستطع، فاسأله كيف عرف عملاؤه سلوك الواجهة حينها.
في كل حالة أنت تقيّم أمرين. الأول: هل تخبرك الواجهة بالحقيقة عن حالة الحجز؟ والثاني: هل يستطيع كودك التصرف بناءً على تلك الحقيقة دون أن يقرأ إنسان نصاً حراً؟ الواجهة التي تفشل بوضوح أسهل في التعايش معها من واجهة تنجح بغموض.
كتبنا بتفصيل أكبر عن جانب الطيران في ربط API حجز الطيران وما لا تقوله الوثائق، وعن تصميم عميل يتحمّل بطء موردي الفنادق في مقال ربط API توفر الفنادق. كلاهما رفيق مفيد لخطة التجربة.
أسئلة تكشف المجمّع الهشّ
لا عيب في المجمّع (Aggregator). معظم محتوى السفر يصل إلى معظم البائعين عبر أحدهم. الخطر في المجمّع الهشّ: طبقة تعيد بيع واجهة طبقة أخرى، وتضيف هامش ربح، ولا تملك عقد المورد ولا مكتب العمليات. حين يتعطل شيء، يجب أن يسافر الجواب عبر شركتين صعوداً ثم يعود.
خمسة أسئلة تكشف ذلك بسرعة:
- من المورد المسجّل لهذا الحجز؟ على عقد مَن مع شركة الطيران أو الفندق يقوم؟
- عبر رقم IATA لمن وعبر أي BSP تصدر التذكرة؟ إن كان الجواب «رقم شريك»، فاسأل: من يستلم مذكرة الخصم (ADM) حين تُخالَف قاعدة سعر؟
- حين أستدعي الإلغاء، ماذا يحدث عندكم؟ استدعاء آلي للمورد، أم طابور يلتقطه موظف؟
- هل أستطيع رؤية الخطأ القادم من المصدر؟ الطبقة الهشة تميل إلى دمج كل فشل في رمز واحد، لأنها لا تفهم تماماً الأخطاء التي تتلقاها.
- بمن أتصل بشأن حجز حقيقي عالق، وبمن يتصل هو؟ عُدّ الحلقات.
لا جواب من هذه يُقصي المزوّد وحده. رقم IATA لشريك قد يكون مقبولاً إن كان العقد واضحاً في تحديد من يتحمل مذكرة الخصم. المهم أن يجيب المزوّد بدقة وبسرعة. الأجوبة المبهمة هنا هي نفسها الأجوبة التي ستسمعها لاحقاً، في بيئة الإنتاج، وفي ساعة أسوأ.
كم يكلّفك الاختيار الخاطئ
الربط التقني هو الجزء الرخيص. الأجزاء المكلفة تأتي لاحقاً ولا تظهر في أي تقدير.
خلل الحجز المكرر يعني عميلاً خُصم منه مرتين، وPNR عليك أن تجده وتلغيه يدوياً، ربما بعد أن أُغلقت نافذة الإبطال المجاني. والحجز الذي نجح عند المصدر بينما سجّل نظامك فشلاً يعني مقعداً محجوزاً ثم ملغى تلقائياً، وعميلاً يظن أن حجزه مؤكد. والناقل الذي عرضته ولم تستطع إصدار تذكرته يعني استرداداً واعتذاراً وعميلاً لا يعود. ومذكرة الخصم (ADM) بسبب قاعدة سعر خالفها مسار المزوّد تقع على من يملك التذكرة — تأكد مسبقاً إن كان ذلك أنت.
ثم هناك كلفة التبديل. كل غرابة في سلوك المزوّد تستوعبها — رمز حالة يعني شيئين، حقل يكون نصاً أحياناً — تنتهي في نموذج بياناتك. بعد سنتين، لا يعود اختيار الواجهة ربطاً يمكنك استبداله في دورة عمل واحدة؛ بل يصبح شكل جدول الحجوزات لديك. هذا هو السبب الحقيقي للمقارنة بعناية الآن.
أين تقع واجهاتنا في هذا الإطار
نوفّر واجهات API للطيران والفنادق. يبدأ الوصول بمحادثة لا بمفتاح ذاتي الخدمة، وبعض المطوّرين يجدون ذلك بطيئاً؛ والسبب أن المحادثة هي المكان الذي تُطرح فيه الأسئلة أعلاه في الاتجاهين — أي المسارات والمدن تحتاجها، وأي محتوى ستتمكن فعلاً من إصداره أو تأكيده، ومن يتولى ماذا بعد الحجز. إن كنت تُجري مقارنة، فأحضر هذه القائمة معك. صفحة واجهات API للسفر هي حيث تبدأ تلك المحادثة.
أياً كان اختيارك، فليكن من سجل التجربة لا من العرض التقديمي. العرض يخبرك بما يريد المزوّد أن يكون. ومسارات الخطأ تخبرك بما هو عليه.