Руководство по eSIM2 мин чтения

Roamify eSIM API Изменения

Узнайте о последних обновлениях eSIM API от Roamify, включая новые постраничные ответы для GET /api/esim/packages, более строгую проверку стран и countryCode…

Donald Bogle

Donald Bogle

Редакция Roamify

Roamify eSIM API Изменения

Мы выпускаем набор обновлений 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 стран
countryCodeISO код страныполе 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, как сравнивать тарифные планы и какие этапы настройки наиболее важны до и во время поездки.

Мгновенная активация

Отправляетесь в новое путешествие? Оставайтесь на связи с момента прибытия.

Доступный мобильный интернет в 200+ направлениях. Без платы за роуминг, без скрытых комиссий, просто отсканируйте и пользуйтесь.

Читать дальше

Все статьи
eSIM для Перу: Полное руководство по подключению на 2026 год
Советы по странам

eSIM для Перу: Полное руководство по подключению на 2026 год

Планируете поездку в Перу в 2026 году? Оставайтесь на связи в Лиме, Куско, Мачу-Пикчу, Священной долине и Амазонке с помощью удобной eSIM. Узнайте, как проверить совместимость устройства, выбрать подходящий тарифный план, понять покрытие по регионам и решить, что выбрать - eSIM или местную SIM. Узнайте, почему доступные eSIM от Roamify (от $2) идеально подходят для путешественников, которые хотят мгновенной активации по прибытии, без роуминга и надежного мобильного интернета по всему Перу.

Marissa Ling Marissa Ling
eSIM для Саудовской Аравии: как оставаться на связи в качестве посетителя в 2026 году
Советы по странам

eSIM для Саудовской Аравии: как оставаться на связи в качестве посетителя в 2026 году

Планируете поездку в Саудовскую Аравию в 2026 году? Избегайте дорогого роуминга и очередей за SIM-картами в аэропорту, используя туристическую eSIM. Этот гид объясняет совместимость eSIM, покрытие на STC, Mobily и Zain, доступность 4G/5G в Эр-Рияде, Джидде, Мекке, Медине и Аль-Уле, сколько данных вам действительно нужно и пошаговую настройку eSIM перед вылетом. Сравните ведущих провайдеров, таких как Roamify, Airalo и Holafly, узнайте о VPN и использовании приложений (WhatsApp, Telegram, социальные сети) и получите практические советы, чтобы оставаться на связи во время Хаджа, Умры, деловых поездок или отдыха в Саудовской Аравии.

Michael HarbourMichael Harbour
Roamify Partner Program: How to Earn Money Reselling eSIMs in 2026
Советы по странам

Roamify Partner Program: How to Earn Money Reselling eSIMs in 2026

Discover the Roamify Partner Program, a high-converting travel eSIM affiliate and reseller opportunity built for bloggers, comparison sites, travel agencies, and digital nomad communities. Promote data-only eSIMs from just $2 with coverage in 200+ countries, a 4.6 Trustpilot rating, top-ranked customer support, and a 5% discount code (ROAM5) to boost conversions. Apply in minutes at partner.getroamify.com and start earning commissions by recommending one of the cheapest, most reliable travel eSIM providers on the market.

Donald BogleDonald Bogle