API لأسعار الطيران: الرقم الظاهر ليس سعر التذكرة بعد

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