במדריך הזה מוסבר איך Merchant API מטפל בניהול גרסאות, בהפצות ובמחזור החיים של הגרסאות השונות שלו.
תכנית ניהול גרסאות
ב-Merchant API נעשה שימוש באסטרטגיית ניהול גרסאות ברמת ה-API המשני. המשמעות היא שלכל Merchant API, לדוגמה Products within the Merchant API, יהיה מחזור חיים משלו של גרסה.
פורמט וסדר הצגה של גרסאות
גרסאות יציבות של ממשקי משנה של API: אם ממשק משנה של API הוא בגרסה יציבה, כל השיטות שלו הן בגרסה יציבה. גרסה יציבה של API משני מיוצגת בתור vX (לדוגמה, v1, v2). אלה גרסאות ראשיות שמוכנות לייצור.
גרסאות אלפא של ממשקי משנה של API: אם ממשק משנה של API נמצא בגרסת אלפא, כל השיטות שלו נמצאות בגרסת אלפא. גרסת אלפא של ממשק משנה של API מיוצגת כ-vXalpha (לדוגמה, v1alpha, v2alpha). היא מכילה תכונות ניסיוניות עם גישה מוקדמת שמיועדות לבדיקה ולחזרה מהירה על איטרציות. גרסאות אלפא לא מגיעות עם הבטחה ליציבות, אין להן משך חיים מוגדר והן יכולות להשתנות או להיות מופסקות עם תקופת הודעה של 30 יום.
שינויים בגרסה
- עלייה במספר הגרסה הראשית (לדוגמה, מגרסה 1 לגרסה 2): מציינת שינויים שעלולים לגרום לכשלים ושינויים שלא תואמים לאחור, שדורשים פעולה מצד המפתח. רק שינויים שוברים בממשקי משנה יציבים של API יקבלו מספר גרסה חדש. לדוגמה, v1 ל-v2.
- שינויים קלים: תוספות או תיקונים שתואמים לאחור מוצגים כשינויים בגרסה הראשית הקיימת. שינויים כאלה יפורטו בהערות לגבי הגרסה הראשית. תוספות שלא גורמות לשינויים שוברים ב-API משני יפורסמו בערוץ אלפא של הגרסה היציבה האחרונה או ישירות בגרסה היציבה האחרונה.
מדיניות הוצאה משימוש
אנחנו מוציאים משימוש מדי פעם גרסאות ישנות יותר של Merchant sub-API. אנחנו מתחייבים לחלון זמן של 12 חודשים להוצאה משימוש של גרסאות יציבות (vX), החל ממועד ההודעה הרשמית על הוצאה משימוש.
לדוגמה, אם נצא משימוש בגרסה 1 של Products sub-API ב-15 בינואר 2026, היא תושבת ב-15 בינואר 2027 או לאחר מכן. אחרי התאריך הזה, הגרסה הקודמת של Products sub-API לא תהיה זמינה יותר לשימוש.
גרסת משנה של API וסטטוס מחזור החיים
בטבלה הבאה מפורטות הגרסאות העדכניות של כל אחד מממשקי המשנה של Merchant API:
| Sub-API | גרסאות | סטטוס |
|---|---|---|
| חשבונות | v1 v1alpha v1beta |
פעיל פעיל יצא משימוש ב-28 בפברואר 2026 |
| המרות | v1 v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
| מקורות נתונים | v1 v1beta |
פעיל הוצא משימוש ב-28 בפברואר 2026 |
| מלאי שטחי הפרסום | v1 v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
| פתרון בעיות | v1 v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
| תוכנית השותפות לניהול פידים של מלאי מוצרים בחנויות מקומיות | v1 v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
| התראות | v1 v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
| מעקב אחר הזמנות | v1 v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
| מוצרים | v1 v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
| Product Studio | v1alpha | פעיל |
| קידומי מכירות | v1 v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
| מכסה | v1 v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
| דוחות | v1 v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
| ביקורות | v1alpha v1beta |
פעיל יצא משימוש ב-28 בפברואר 2026 |
שיטות מומלצות
- כדאי לעיין באופן קבוע בהערות המוצר ובעדכונים האחרונים כדי לקבל מידע על גרסאות חדשות, עדכונים חשובים, שיפורים והודעות על השקות של רכיבי API ועל הוצאה משימוש של רכיבי API.
- אם ל-API משני יש שתי גרסאות יציבות או יותר, מומלץ להשתמש תמיד בגרסה העדכנית ביותר.
- כדאי לתכנן את האפליקציה כך שתטפל בצורה חלקה בשגיאות שונות של ממשקי משנה של API, כולל בעיות ברשת, מגבלות קצב וקודי שגיאה או הודעות שגיאה חדשים שעשויים להופיע בגרסאות חדשות יותר של ממשקי משנה של API.
- אל תחכו עד שגרסת משנה של API עומדת לצאת משימוש כדי להתחיל לתכנן את השדרוג. כדאי להתחיל להעריך ולבדוק גרסאות חדשות ברגע שהן זמינות.
- אם יש לכם בקשות לתכונות או חששות לגבי תוכנית הדרך של API משני, אתם יכולים לפנות אלינו עם שאלות או משוב. במאמר קבלת עזרה בנושא Merchant API מוסבר איך ליצור קשר עם צוות Merchant API לקבלת תמיכה טכנית.