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

אינטגרציה של API להזמנת טיסות: מה שהתיעוד לא מספר

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

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

המאמר נכתב למפתח שמעולם לא ראה PNR. הוא לא עוסק ב-endpoints של ספק מסוים; השמות משתנים מספק לספק, המבנה לא.

רצף הקריאות באינטגרציה של API להזמנת טיסות

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

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

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

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

למה המחיר שחיפשתם אינו המחיר שהזמנתם

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

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

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

אידמפוטנטיות, ומה המשמעות של timeout בזמן הזמנה

את הפרק הזה כדאי לקרוא פעמיים.

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

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

מה שעובד, בערך בסדר הזה:

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

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

מושגי תיירות שמפתיעים מפתחי ווב

אף אחד מהם לא קשה. כל אחד מהם עלה למישהו שבוע, כי הוא לא ידע שהוא קיים.

PNR אינו כרטיס

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

שמות כמעט בלתי ניתנים לשינוי

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

סוג נוסע הוא מחיר, לא קישוט

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

השעות מקומיות, וסגמנט אינו לג

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

דברים קורים אחרי המכירה

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

Void אינו החזר

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

כמה עולה טעות

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

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

בדיקות מול API טיסות

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

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

מערכת Tekravel

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

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