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

לפני ששוכרים חברת אינטגרציית API בדובאי

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

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

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

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

מה חברת אינטגרציית API בדובאי יכולה לספק, ומה לא

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

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

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

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

הבריף: שבע שורות למפרט העבודה

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

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

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

שלוש דרכים להביא תוכן של ספק לאתר

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

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

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

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

איפה הפלטפורמה הזו נכנסת

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

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

כמה עולה בריף חלש

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

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

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

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

מערכת Tekravel

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

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