דילוג לתוכן
בלוג

השהיית API לתיירות: מה אפשר לתקן ומה לא

מערכת Tekravel
נכתב בסיוע בינה מלאכותית

בכרטיס התמיכה כתוב "החיפוש איטי". אתם פותחים את ה-trace של טיסה הלוך ושוב תל אביב–דובאי, והקוד שלכם הוא פס דק בהתחלה ועוד פס דק בסוף. כל מה שביניהם הוא המתנה: ל-GDS, לשתי חברות תעופה ב-NDC, לאגרגטור מלונות שעונה מתי שמתחשק לו. השהיית API לתיירות היא בעיית הביצועים היחידה שבה הפרופיילר מצביע שוב ושוב על קוד שלא כתבתם ושאינכם יכולים לפרוס. זה משנה את המשמעות של "לתקן", ורוב המאמץ שצוותים משקיעים בזה הולך לחצי הלא נכון.

לאן באמת הולכת השהיית API לתיירות בחיפוש מרובה ספקים

חיפוש טיסה אחד במנוע הזמנות אינו בקשה אחת. זה fan-out. המנוע לוקח מוצא, יעד, תאריכים והרכב נוסעים, בונה בקשה בפורמט של כל ספק שמותר לו לשאול בנתיב הזה, שולח את כולן בבת אחת, ומחכה. לכל ספק שעון משלו: סשן GDS שהיה חם או לא, שער NDC שמתמחר מחדש בצד חברת התעופה, bedbank שבעצמו מפזר את הבקשה למנהלי הערוצים שמאחוריו. התוצאה שאפשר להראות למשתמש חסומה מלמטה על ידי הספק האיטי ביותר שבחרתם לחכות לו, לא על ידי הממוצע.

זה הדבר הראשון שצריך להפנים. הוספת ספק לעולם לא מאיצה חיפוש מלא. היא רק מוסיפה עוד נתיב שחייב להסתיים לפני שסט התוצאות "מוכן".

ואז התשובות חוזרות, ומתחילה העבודה שבאמת שלכם: לפרסר מטען XML או JSON גדול מכל ספק, למפות את קודי שדות התעופה, חברות התעופה והתעריפים שלהם לשלכם, לבטל כפילויות של אותו מסלול ששלושה מקורות החזירו בשלושה מחירים, להחיל את כללי המרווח של הדייר ששואל, להמיר לשקלים ולמיין. בנתיב עמוס השלב הזה לא חינם, והוא המקום היחיד שבו פרופיילר יגיד לכם משהו שאפשר לפעול לפיו. על צד המלונות כתבנו בתכנון לקוח זמינות מלונות לספקים איטיים; לצד הטיסות אותה צורה, עם יותר קודים למפות.

אז הפירוק הכן של חיפוש איטי הוא שלושה דליים:

  • המתנה לספק: התשובה הארוכה ביותר של ספק יחיד. לא בשליטתכם.
  • העיבוד שלכם: פרסור, מיפוי, ביטול כפילויות, תמחור, מיון. כולו בשליטתכם.
  • מסירה: סריאליזציה של התוצאה הממוזגת והעברתה לדפדפן. בדרך כלל קטן, לפעמים ההפתעה.

החצי שאפשר לתקן, והחצי שכדאי להפסיק לנסות

התחילו בדלי השני, כי הוא שלכם. הממצאים הרגילים, בסדר שבו הם נוטים להופיע: שלב מיפוי ששולף כל קוד שדה תעופה מבסיס הנתונים אחד-אחד במקום לטעון את הטבלה פעם אחת; המרת מטבע שקוראת לשירות השערים לכל תעריף במקום לכל חיפוש; רוטינת ביטול כפילויות שמשווה כל מסלול לכל מסלול אחר; סריאליזציה שעוברת מחדש על גרף האובייקטים לכל דייר. שום דבר מזה לא אקזוטי. הכול ניתן לתיקון בספרינט אחד, והתיקון מחזיק.

ניהול חיבורים הוא המקום השני שבו הרווח אמיתי. לחיצת יד TLS חדשה מול הספק בכל חיפוש היא תקורה טהורה; מאגר חיבורים חמים שנשמרים בין חיפושים מסיר אותה. סשני GDS במיוחד יקרים לפתיחה וזולים לשימוש חוזר, ולכן ניהול סשנים הוא פיצ'ר מוצר בעולם הזה ולא פרט מימוש.

ועכשיו החצי שצריך להפסיק לתקן. אי אפשר לגרום לספק לענות מהר יותר. אפשר ללחוץ על מנהל הלקוח, ולפעמים נתיב עובר לצומת מהיר יותר, אבל זמן התגובה של מערכת של מישהו אחר אינו משתנה בפריסה שלכם. צוותים ששוכחים את זה מבזבזים רבעונים על צמצום העיבוד שלהם מפס דק לפס דק יותר, בעוד ההמתנה לספק, שהייתה רוב הזמן הכולל, לא זזה. הפרופיילר היה כן איתם. הם פשוט המשיכו לייעל את החלק שהוא אמר שבסדר.

מה שאפשר לעשות עם ספק איטי הוא להחליט כמה זמן אתם מוכנים לחכות לו, ומה המשתמש רואה בינתיים. על זה שאר המאמר.

רינדור הדרגתי הוא התשובה הכנה

אם סט התוצאות המלא חסום על ידי הספק האיטי ביותר, הדרך היחידה להראות למשתמש משהו מוקדם יותר היא להפסיק לחכות שהסט יהיה מלא. הציגו תוצאות מהספק הראשון שעונה. הוסיפו את תוצאות הספק הבא כשהן מגיעות. תנו למשתמש להתחיל לקרוא, לסנן ולהשוות בזמן שהמאחרים עדיין בדרך. זהו רינדור הדרגתי, וזה לא טריק; זה ייצוג מדויק של מה שקורה בפועל בשרת.

יש לזה השלכות שעדיף לתכנן מאשר לגלות:

  • יציבות המיון. רשימה ממוינת לפי מחיר שממוינת מחדש בכל פעם שספק מגיע תזיז את התעריף שהמשתמש עמד ללחוץ עליו. הכניסו תוצאות חדשות במקומן, או צברו אותן ותנו למשתמש למשוך, אבל אל תערבבו מתחת לסמן.
  • "הזול ביותר" זמני. עד שהספק האחרון נכנס, כל טענה על התעריף הנמוך ביותר היא טענה על הספקים שענו בלבד. הממשק צריך להציג את המצב הזה במקום להעמיד פנים של שלמות.
  • שלב ההזמנה חייב לבדוק מחדש. תעריף שהוצג מתשובה מוקדמת עלול להיעלם עד שהמשתמש לוחץ. זה נכון גם בעיצובים לא הדרגתיים, אבל רינדור הדרגתי מגדיל את החלון. המאמר על אינטגרציית ההזמנה מכסה את שלב התמחור מחדש; כאן הוא לא אופציונלי.
  • המטמון נהיה פשוט יותר, לא קשה יותר. תוצאות לפי ספק אפשר לשמור במטמון עם אורך חיים לפי ספק. תעריפים סטטיים של bedbank יכולים לחיות שעות; הצעת NDC, דקות. תוצאה ממוזגת מונוליתית אחת כופה את אורך החיים הקצר ביותר על הכול.

צורת ה-API שתומכת בזה היא חיפוש שמחזיר מזהה מיד ומאפשר ללקוח לדגום או להירשם לתוצאות ככל שהן מגיעות, כשכל אצווה מתויגת לפי מקור ועם דגל שאומר אם החיפוש עדיין פתוח. ה-API לטיסות ולמלונות של הפלטפורמה בנויים סביב הצורה הזו; עמוד ה-API לתיירות מתאר את הממשקים, והגישה מתחילה בשיחה ולא במפתח בשירות עצמי, אז תביאו את השאלות.

timeout לכל ספק, לא לכל בקשה

timeout אחד על כל החיפוש הוא הטעות הנפוצה ביותר בשכבה הזו, והיא שגויה בשני הכיוונים בו זמנית. קבעו אותו קצר, וספק איטי אבל יקר ערך נחתך בכל חיפוש ואתם מפסיקים בשקט למכור את המלאי שלו. קבעו אותו ארוך, וספק אחד שנתקע מחזיק את כל התוצאות כבנות ערובה, כולל אלה שהגיעו מיד.

החלטהtimeout יחיד לכל החיפושתקציב לכל ספק
ספק אחד נתקעכולם מחכים, ואז כולם נכשלים או כולם נחתכיםהספק הזה מושמט מהחיפוש הזה; השאר מוצגים
ספק איטי עם תעריפים טוביםאו תמיד מוחרג או תמיד מאט את הדףמקבל תקציב ארוך יותר מהמהירים ומוצג מאוחר
ניסיון חוזרכל ה-fan-out מנוסה מחדש, מכפיל עומס על ספקים שכבר ענורק זה שנכשל מנוסה מחדש, אם זה בכלל שווה
מה המשתמש רואהספינר, ואז הכול או שגיאהתוצאות שמתמלאות, ומצב "עדיין מחפש" שנסגר בסוף
מה התפעול רואה"החיפוש פג", בלי שום סימן איזה מקור גרם לזהמונה timeout לכל ספק שאפשר לשים ליד השם שלו
כוונוןמספר אחד שמתווכחים עליו לנצחמספר לכל ספק, שנגזר מההיסטוריה שלו עצמו

התקציב לכל ספק הוא גם המקום שבו חיה המציאות המסחרית. ספק שהתעריפים שלו נבחרים לעיתים רחוקות לא ראוי לאותה סבלנות כמו זה שזוכה ברוב ההזמנות שלכם בנתיב. תעריפי נטו של קונסולידטור בנתיב ישראל–אירופה אולי שווים המתנה; bedbank רביעי שמחזיר את אותם מלונות כמו שלושת הראשונים, לא. התקציב הוא החלטת מוצר שמבוטאת במספר, וצריך לקבוע אותו לכל ספק, לכל דייר אם הדיירים שונים, ולבחון מחדש.

שני עידונים שמשלמים את עצמם. ראשית, תקציב אינו רק מקסימום; ספק שחוזר בחלק קטן מהתקציב שלו אבל עם סט ריק הוא אות שונה מספק שפג לו הזמן, ויש לספור את השניים בנפרד. שנית, ניסיונות חוזרים שייכים לרמת הספק וצריכים להיות נדירים. חיפוש חוזר מול ספק שזה עתה פג לו הזמן פירושו בדרך כלל שני חיפושים בתור בצד שלהם, מה שמאט גם את הבא, ובחוזים לפי שימוש זה עולה כסף.

מה למדוד כדי שלמספר תהיה משמעות

"זמן חיפוש ממוצע" הוא המספר שכולם מדווחים וזה שאומר הכי פחות. הוא מערבב שליפת מלון מהמטמון עם fan-out בינלאומי של שישה ספקים, מסתיר את הספק שהוא הסיבה, וזז כשתמהיל התנועה זז ולא כשהקוד שלכם משתנה. החליפו אותו בסט קטן של מדידות שכל אחת עונה על שאלה אחת.

  1. זמן עד התוצאה הראשונה, לכל חיפוש. זה מה שהמשתמש חווה כמהירות. הוא חסום על ידי הספק המהיר ביותר שלכם ועוד התקורה שלכם, שזה החלק שבאמת אפשר לשפר.
  2. זמן עד השלמה, לכל חיפוש, עם זהות הספק שסגר אותו. אם ספק אחד תמיד אחרון, זו שיחת תקציב, לא עניין הנדסי.
  3. זמן תגובה לכל ספק, כהתפלגות ולא כממוצע, מתויג לפי נתיב ושעה ביום. ספק שבסדר בבוקר ואיטי בערב נראה בסדר בממוצע ואינו כזה.
  4. timeout כסוג תוצאה, שנספר לצד "החזיר תוצאות" ו"החזיר ריק", לכל ספק. timeout הוא תוצאה שלא קיבלתם, ומקומו באותו גרף כמו אלה שכן קיבלתם.
  5. זמן העיבוד שלכם, בנפרד. כשהוא גדל, יש לכם בעיית קוד. כשההמתנה לספק גדלה, יש לכם שיחה.
  6. חיפושים לכל הזמנה, לכל ספק ולכל דייר. כל חיפוש שאתם שולחים עולה לספק קיבולת, ורוב החוזים אכפת להם מהיחס הזה. תיקון השהיה שמכפיל את נפח החיפושים דרך ניסיונות חוזרים הפך את המספר לגרוע יותר, לא לטוב יותר.

מדדו גם בנקודה שבה המשתמש רואה את זה. שרת שמדווח על חיפושים מהירים בזמן שהדפדפן מחכה לשלב סריאליזציה איטי אומר את האמת ומטעה אתכם בו זמנית.

מה זה עולה לכם כשטועים

העלות הברורה היא זו שבכרטיס: משתמש שמחכה ואז עוזב. הפחות ברורות הן מסחריות. timeout יחיד על כל החיפוש שנקבע קצר מדי מסיר בשקט ספק מהתוצאות שלכם בכל חיפוש, ואתם מגלים רק כשמנהל הלקוח שואל למה ההזמנות נעצרו. ניסיון חוזר של fan-out שלם מכפיל את החיפושים לכל הזמנה, וספקים שמודדים את היחס הזה מגיבים בהגבלה או בחשבונית. מיון מחדש של רשימה הדרגתית מתחת לסמן של המשתמש מייצר לחיצות שגויות על התעריף הלא נכון, שהופכות לכרטיסי תמיכה ולפעמים להחזרים. ולוח מחוונים מבוסס ממוצע נותן לשלושת הדברים האלה לקרות בזמן שהמספר עליו נשאר ירוק.

שום דבר מזה לא נפתר על ידי האצת הקוד שלכם. זה נפתר על ידי החלטה, לכל ספק, כמה זמן תחכו, הצגת מה שיש לכם למשתמש בזמן ההמתנה, ומדידת הדבר שבאמת זז. האצות הקוד שוות את זה. הן פשוט לא היו החלק שהיה שגוי.

מערכת Tekravel

דסק טכנולוגיות תיירות

דסק טכנולוגיות התיירות של Tekravel כותב לאנשי הענף: בעלי סוכנויות, קונסולידטורים והמפתחים שמחברים אליהם מערכות. כל כתבה נבדקת מול הפלטפורמה שהיא מתארת לפני הפרסום.