תכנון אינטגרציה לאתר או לשותף

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

הגדרת חילופי המידע

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

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

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

קבלת המפרט הטכני העדכני

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

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

תכנון לטיפול בתקלות שגרתיות

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

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

אימות המסלול כולו

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

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

תכנון תפעול ושינויים

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

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