Roamify eSIM API Зміни
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 endpoint — довільні рядки більше не приймаються.
| Parameter | Accepted value | Source |
|---|---|---|
| country | Повна назва країни | name field from the Country API |
| countryCode | ISO код країни | code field from the Country API |
Action required: Якщо ви наразі передаєте рядки з назвами країн у вільному тексті, оновіть вашу інтеграцію, щоб спочатку викликати GET /api/esim/countries і використовуйте name або code значення з відповіді.
Нові кінцеві точки #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Повертає список усіх країн, підтримуваних eSIM Roamify. Використовуйте значення 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 є true в об'єкті пакета. Якщо потрібно і не надано, запит на створення профілю не вдасться.
| Ім'я | Тип | Обов'язково | Опис |
|---|---|---|---|
| датаПочатку | рядок | умовний | Дата початку подорожі у форматі ISO 8601. Обов'язково, якщо requirements.travelDate є true. |
Нагадування про тайм-аут
Повна документація API #
Повна документація доступна за docs.getroamify.com.
Якщо у вас є питання або вам потрібна допомога з оновленням вашої інтеграції, зверніться до нашої команди підтримки партнерів.
Пов’язані плани призначення eSIM
Часті запитання
- Що я дізнаюся з Roamify eSIM API Зміни?
- Ви дізнаєтесь, як працює активація eSIM, як порівнювати тарифні плани та які кроки налаштування є найважливішими до та під час подорожі.
- Як вибрати правильний план eSIM для Японія?
- Зіставте свій план із тривалістю поїздки, очікуваним щоденним використанням даних, потребами в точках доступу та якістю мережі у пункті призначення. Для короткострокового перебування зазвичай потрібно менше даних, тоді як для віддаленої роботи та відеодзвінків потрібно більше.
- Де я можу придбати туристичні плани eSIM для Японія та Таїланд?
- Використовуйте посилання на пункти призначення в цьому посібнику, щоб перейти безпосередньо на сторінки країни Roamify, порівняти варіанти планів і завершити оформлення перед відправленням.