مزود API للسفر والسياحة: حدّد أولاً ما الذي تبنيه

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