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 конечная точка — произвольные строки больше не принимаются.
| Параметр | Принятое значение | Источник |
|---|---|---|
| страна | Полное название страны | поле name из API стран |
| countryCode | ISO код страны | поле code из API стран |
Требуется действие: Если вы в настоящее время передаете строки стран в свободном формате, обновите вашу интеграцию, чтобы сначала вызвать 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 в объекте пакета. Если требуется и не предоставлено, запрос на создание профиля завершится неудачей.
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
| startDate | строка | условный | Дата начала поездки в формате ISO 8601. Обязательно, если requirements.travelDate равно true. |
Напоминание о тайм-ауте
Полная документация API #
Полная документация доступна по адресу docs.getroamify.com.
Если у вас есть вопросы или вам нужна помощь в обновлении вашей интеграции, свяжитесь с нашей командой поддержки партнеров.
Соответствующие планы назначения eSIM
Часто задаваемые вопросы
- Чему я научусь в Roamify eSIM API Изменения?
- Вы узнаете, как работает активация eSIM, как сравнивать тарифные планы и какие этапы настройки наиболее важны до и во время поездки.
- Как выбрать правильный план eSIM для Япония?
- Сопоставьте свой план с продолжительностью поездки, ожидаемым ежедневным использованием данных, потребностями в точках доступа и качеством сети в пункте назначения. При кратковременном пребывании обычно требуется меньше данных, а при удаленной работе и видеозвонках — больше.
- Где я могу приобрести планы eSIM для путешествий для Япония и Таиланд?
- Используйте ссылки на пункты назначения в этом руководстве, чтобы перейти непосредственно на страницы стран Roamify, сравнить варианты плана и завершить оформление заказа перед отъездом.