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

API להזמנת מלונות בחינם: מה באמת מקבלים בחינם

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

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

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

ארבעה דברים ש"חינם" יכול להיות

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

מה ההצעה החינמיתמה מקבליםמה אפשר לבנותמה היא לא יכולה לעשות
תוכן סטטי או נתוני מדריךשמות מלונות, כתובות, תמונות, מתקנים, תיאוריםמדריך מלונות, מפה, דף יעדלהציג מחיר שאפשר לעמוד מאחוריו, או חדר שבאמת פנוי בתאריכים שלכם
חיפוש שותפים (affiliate) עם הפניהמלונות ומחירים, וקישור החוצה לקופה של המוכר עצמודף השוואה ששולח את התנועה הלאהלהשאיר אצלכם את הלקוח, את התשלום או את רשומת ההזמנה
Sandbox עם תעריפי בדיקהקריאות החיפוש, התמחור, ההזמנה והביטול המלאות, שעונות עם מלאי מומצאאינטגרציה עובדת והדגמה שמתנהגת כמו productionליצור הזמנה שמלון אמיתי יכבד
תעריפים חיים להזמנהחדרים אמיתיים במחירי net או מכירה אמיתיים, מאושרים על ידי הספקחנות שגובה כסף על חדריםלהיות בחינם עבור מי שחותם על החוזה

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

למה תעריף שאפשר להזמין תמיד מגיע עם חוזה

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

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

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

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

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

מה לבדוק ב-sandbox לפני שחותמים על חוזה כלשהו

ה-sandbox הוא הדבר החינמי השימושי ביותר בטבלה, אז תשתמשו בו בלי רחמים. sandbox טוב מאפשר לבצע כל שלב שהזמנה אמיתית עוברת, עם מלאי מזויף אבל בצורה של הדבר האמיתי.

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

אם ה-sandbox לא מסוגל לבצע את שלבים ארבע וחמש, יש לכם API תוכן עם URL שנראה כמו הזמנה.

כמה עולה לבנות על הסוג הלא נכון

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

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

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

איפה הפלטפורמה הזו עומדת

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

לתוכן חינמי, לקישורי שותפים ול-sandbox יש לכל אחד את מקומו, והנכון תלוי במה שאתם מתכוונים למכור. בחרו לפי מה שהמפתח יכול לעשות ביום שבו לקוח משלם.

מערכת Tekravel

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

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