שינויים קריטיים ב-API של Roamify eSIM
Donald Bogle
June 9, 2026 22:20
אנחנו משיקים סדרת עדכוני API שמביאה נקודות קצה חדשות, פונקציות מורחבות, וכמה שינויים שתרצה להיות מודע להם לפני עדכון האינטגרציה שלך.
⚠️ שינויים קריטיים — קבל חבילות eSIM #
נקודת קצה: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. התגובה עכשיו ממוספרת #
נקודת הקצה הזו עכשיו מחזירה תוצאות ממוספרות במקום את כל החבילות בתגובה אחת. אם האינטגרציה שלך מושכת חבילות ללא פרמטרי מיספור, ייתכן שאתה מקבל רק את העמוד הראשון של התוצאות.
דרושה פעולה: עדכן את האינטגרציה שלך כדי לטפל בתגובות ממוספרות באמצעות ה-page ו-pageSize פרמטרי השאילתה.
| פרמטר | סוג | ברירת מחדל | תיאור |
|---|---|---|---|
| עמוד | מחרוזת | 1 | מספר העמוד שיש לשלוף. |
| גודל עמוד | מחרוזת | 50 | מספר התוצאות לכל עמוד. |
כדי לשלוף את כל החבילות, חזור על העמודים עד שהתגובה מחזירה פחות תוצאות מאשר ה-גודל עמוד.
2. מדינה ו-קוד מדינהכעת יש להם משמעויות שונות #
בעבר שדות אלו עשויים היו לשמש לסירוגין. כעת הם משרתים מטרות שונות ו-שניהם חייבים להשתמש בערכים שמקורם ב- GET /api/esim/countries נקודת קצה — מחרוזות שרירותיות לא מתקבלות יותר.
| פרמטר | ערך מתקבל | מקור |
|---|---|---|
| מדינה | שם מלא של המדינה | שדה שם מ- Country API |
| countryCode | קוד מדינה ISO | שדה קוד מ- Country API |
דרושה פעולה: אם אתה מעביר כרגע מחרוזות מדינה בטקסט חופשי, עדכן את האינטגרציה שלך כדי לקרוא קודם ל- GET /api/esim/countries ולהשתמש ב- name או code ערכים מהתגובה.
נקודות קצה חדשות #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
מחזיר רשימה של כל המדינות הנתמכות על ידי Roamify eSIM. השתמש ב-name וב-code כערכי סינון כאשר אתה שואל על GET /api/esim/packages.
פרמטר סינון אופציונלי זמין עם geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
שלח הודעת SMS ישירות ל-eSIM.
| שם | סוג | נדרש | תיאור |
|---|---|---|---|
| iccid | מחרוזת | נדרש | ה-ICCID של ה-eSIM לשליחת ה-SMS. |
| הודעה | מחרוזת | נדרש | תוכן ההודעה לשליחה. |
נקודות קצה מעודכנות #
POST /api/esim/apply — startDate נתמך כעת #
שדה חדש אופציונלי startDate נוסף לנקודת הקצה של יצירת פרופיל eSIM. עבור תת-קבוצה קטנה של חבילות (~30 מתוך 28,000+), שדה זה הוא נדרש.
אתה יכול לזהות את החבילות הללו על ידי בדיקה אם requirements.travelDate הוא נכון במבנה החבילה. אם נדרש ולא סופק, הבקשה ליצירת פרופיל תיכשל.
| שם | סוג | נדרש | תיאור |
|---|---|---|---|
| startDate | מחרוזת | תנאי | תאריך תחילת הטיול בפורמט ISO 8601. נדרש אם requirements.travelDate הוא true. |
תזכורת על זמן ההמתנה
מדריך API מלא #
תיעוד מלא זמין ב- docs.getroamify.com.
אם יש לך שאלות או זקוק לעזרה בעדכון האינטגרציה שלך, פנה לצוות התמיכה של השותפים שלנו.
תוכניות יעד קשורות ל-eSIM
שאלות נפוצות
- מה אלמד ב-שינויים קריטיים ב-API של Roamify eSIM?
- תלמד כיצד פועלת הפעלת eSIM, כיצד להשוות תוכניות נתונים, ואילו שלבי הגדרה חשובים ביותר לפני ובמהלך הטיול שלך.
- כיצד אוכל לבחור את תוכנית ה-eSIM הנכונה עבור יפן?
- התאם את התוכנית שלך לאורך הנסיעה, השימוש היומי הצפוי בנתונים, צרכי הנקודה החמה ואיכות הרשת ביעד שלך. שהיות קצרות בדרך כלל דורשות פחות נתונים, בעוד עבודה מרחוק ושיחות וידאו זקוקות ליותר.
- היכן אוכל לקנות תוכניות eSIM לנסיעות עבור יפן ותאילנד?
- השתמש בקישורי היעד במדריך זה כדי לעבור ישירות לדפי מדינות Roamify, להשוות אפשרויות תוכנית ולהשלים את התשלום לפני היציאה.