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

زمن استجابة API السفر: ما تصلحه وما تتركه

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

تصلك تذكرة الدعم بعبارة واحدة: «البحث بطيء». تفتح تتبّع الطلب لرحلة ذهاب وعودة بين الرياض ودبي، فتجد أن الكود الذي كتبته أنت يشغل شريحة رفيعة في البداية وأخرى في النهاية، وأن كل ما بينهما انتظار: انتظار نظام التوزيع العالمي (GDS)، وانتظار شركتي طيران عبر قدرات التوزيع الجديدة (NDC)، وانتظار مجمّع فنادق يردّ متى شاء. زمن استجابة API السفر هو مشكلة الأداء الوحيدة التي يظل فيها المحلّل يشير إلى كود لم تكتبه ولا تستطيع نشره. وهذا يغيّر معنى «الإصلاح» من أساسه، ومعظم الجهد الذي تبذله الفرق هنا يذهب إلى النصف الخطأ.

أين يذهب الوقت فعلاً عند ربط API حجز الطيران بعدة موردين

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

هذه أول حقيقة ينبغي استيعابها: إضافة مورد جديد لا تجعل البحث الكامل أسرع أبداً. هي تضيف مساراً آخر يجب أن يكتمل قبل أن تُعتبر النتائج «جاهزة».

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

إذن التقسيم الصادق للبحث البطيء ثلاث حزم:

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

النصف الذي تصلحه، والنصف الذي يجب أن تتوقف عن محاولة إصلاحه

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

إدارة الاتصالات هي الموضع الآخر الذي يكون فيه المكسب حقيقياً. مصافحة TLS جديدة مع المورد في كل بحث عبء خالص؛ ومجمّع اتصالات دافئة يبقى حياً عبر عمليات البحث يزيله. جلسات GDS تحديداً مكلفة في الفتح ورخيصة في إعادة الاستخدام، ولهذا تُعدّ إدارة الجلسات ميزة منتج في ذلك العالم لا تفصيلاً تنفيذياً.

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

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

العرض التدريجي هو الجواب الصادق

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

وله تبعات يُستحسن تصميمها لا اكتشافها:

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

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

مهلة لكل مورد، لا مهلة للطلب كله

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

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

الميزانية لكل مورد هي أيضاً حيث يعيش الواقع التجاري. مورد نادراً ما تُختار أسعاره لا يستحق الصبر نفسه الذي يستحقه من يفوز بمعظم حجوزاتك على مسار ما. الأسعار الصافية (Net Rates) من وكيل معتمد لدى IATA على مسار الخليج–شبه القارة الهندية قد تستحق الانتظار؛ أما بنك غرف رابع يعيد الفنادق نفسها التي أعادها الثلاثة قبله فلا. الميزانية قرار منتج مكتوب برقم، ويجب أن تُضبط لكل مورد، ولكل وكالة إن اختلفت الوكالات، وتُراجع.

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

ماذا تقيس ليكون للرقم معنى

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

  1. الزمن حتى أول نتيجة، لكل بحث. هذا ما يختبره المستخدم بوصفه سرعة. وهو محدود بأسرع مورد لديك زائد عبئك أنت، وهذا هو الجزء الذي تستطيع تحسينه فعلاً.
  2. الزمن حتى الاكتمال، لكل بحث، مع هوية المورد الذي أغلقه. إن كان مورد واحد دائماً الأخير، فهذه محادثة ميزانية لا مسألة هندسية.
  3. زمن استجابة كل مورد، كتوزيع لا كمتوسط، موسوماً بالمسار ووقت اليوم. مورد سليم صباحاً وبطيء مساءً يبدو سليماً على المتوسط وليس كذلك.
  4. انتهاء المهلة كصنف نتيجة، يُعدّ بجانب «أعاد نتائج» و«أعاد فارغاً»، لكل مورد. انتهاء المهلة نتيجة لم تحصل عليها، ومكانها الرسم نفسه الذي فيه النتائج التي حصلت عليها.
  5. زمن معالجتك اللاحقة، منفصلاً. حين ينمو هذا فلديك مشكلة كود. وحين ينمو انتظار المورد فلديك محادثة.
  6. عمليات البحث لكل حجز، لكل مورد ولكل وكالة. كل بحث ترسله يكلّف المورد سعة، ومعظم العقود تهتم بهذه النسبة. إصلاح للزمن يضاعف حجم بحثك عبر إعادة المحاولات جعل الرقم أسوأ لا أفضل.

قِس أيضاً عند النقطة التي يراها المستخدم. خادم يبلّغ عن بحث سريع بينما المتصفح ينتظر خطوة تسلسل بطيئة يقول الحقيقة ويضلّلك في الوقت نفسه.

ماذا يكلفك الخطأ هنا

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

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

تحرير Tekravel

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

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