Roamify eSIM API Zmiany
Odkryj najnowsze aktualizacje API eSIM Roamify, w tym nowe paginowane odpowiedzi dla GET /api/esim/packages, surowszą walidację krajów i countryCode za pomocą…
Wprowadzamy zestaw aktualizacji API, które wprowadzają nowe punkty końcowe, rozszerzoną funkcjonalność i kilka zmian, o których warto wiedzieć przed aktualizacją integracji.
⚠️ Zmiany łamiące — Pobierz pakiety eSIM #
Punkt końcowy: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Odpowiedź jest teraz stronicowana #
Ten punkt końcowy teraz zwraca stronicowane wyniki zamiast wszystkich pakietów w jednej odpowiedzi. Jeśli Twoja integracja pobiera pakiety bez parametrów stronicowania, możesz otrzymywać tylko pierwszą stronę wyników.
Wymagana akcja: Zaktualizuj swoją integrację, aby obsługiwała stronicowane odpowiedzi, używając parametrów zapytania page i pageSize.
| Parametr | Typ | Domyślny | Opis |
|---|---|---|---|
| strona | ciąg | 1 | Numer strony do pobrania. |
| rozmiarStrony | ciąg | 50 | Liczba wyników na stronę. |
Aby pobrać wszystkie pakiety, iteruj przez strony, aż odpowiedź zwróci mniej wyników niż twój rozmiarStrony.
2. kraj oraz kodKraju mają teraz różne znaczenia #
Wcześniej te pola mogły być używane zamiennie. Teraz służą różnym celom i oba muszą używać wartości pochodzących z GET /api/esim/countries endpoint — dowolne ciągi nie są już akceptowane.
| Parameter | Accepted value | Source |
|---|---|---|
| country | Pełna nazwa kraju | pole name z API Krajów |
| countryCode | Kod kraju ISO | pole code z API Krajów |
Action required: Jeśli obecnie przesyłasz ciągi krajów w formie wolnego tekstu, zaktualizuj swoją integrację, aby najpierw wywołać GET /api/esim/countries i użyj wartości name lub code z odpowiedzi.
Nowe punkty końcowe #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Zwraca listę wszystkich krajów obsługiwanych przez Roamify eSIM. Użyj wartości name i code z tej odpowiedzi jako filtrów podczas zapytania GET /api/esim/packages.
dostępny opcjonalny parametr filtru z geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Wyślij wiadomość SMS bezpośrednio na eSIM.
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| iccid | string | wymagane | ICCID eSIM, na który należy wysłać SMS. |
| wiadomość | string | wymagane | Treść wiadomości do wysłania. |
Zaktualizowane punkty końcowe #
POST /api/esim/apply — startDate teraz obsługiwane #
Nowe opcjonalne startDate pole zostało dodane do punktu końcowego Generowania profilu eSIM. Dla małej grupy pakietów (~30 z 28 000+), to pole jest wymagane.
Możesz zidentyfikować te pakiety, sprawdzając, czy requirements.travelDate jest prawda w obiekcie pakietu. Jeśli wymagane i niepodane, żądanie generowania profilu zakończy się niepowodzeniem.
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| dataRozpoczęcia | ciąg | warunkowe | Data rozpoczęcia podróży w formacie ISO 8601. Wymagana, jeśli requirements.travelDate jest prawdziwe. |
Przypomnienie o czasie oczekiwania
Pełna dokumentacja API #
Pełna dokumentacja jest dostępna pod adresem docs.getroamify.com.
Jeśli masz jakiekolwiek pytania lub potrzebujesz pomocy w aktualizacji swojej integracji, skontaktuj się z naszym zespołem wsparcia partnerów.
Często zadawane pytania
Dowiesz się, jak działa aktywacja eSIM, jak porównać plany transmisji danych i jakie kroki konfiguracji są najważniejsze przed i w trakcie podróży.
Dopasuj swój plan do długości podróży, oczekiwanego dziennego wykorzystania danych, potrzeb hotspotów i jakości sieci w miejscu docelowym. Krótkie pobyty zwykle wymagają mniej danych, podczas gdy praca zdalna i rozmowy wideo wymagają więcej.
Skorzystaj z łączy do miejsc docelowych w tym przewodniku, aby przejść bezpośrednio do stron krajów Roamify, porównać opcje planów i dokończyć transakcję przed wylotem.
Popularne plany eSIM
Starannie wybrane destynacje na Twoją następną podróż.
Kup plany eSIM w Turcja
Kup plany eSIM w Tajlandia
Kup plany eSIM w Zjednoczone Emiraty Arabskie
Kup plany eSIM w Singapur
Kup plany eSIM w Australia
Kup plany eSIM w MeksykWybierasz się w nowe miejsce? Bądź online już w chwili lądowania.
Tani internet w podróży w ponad 200 destynacjach. Bez opłat roamingowych, bez ukrytych kosztów, wystarczy zeskanować i ruszać w drogę.
Czytaj dalej
Wszystkie artykuły
eSIM dla Peru: Kompletny przewodnik po łączności na 2026 rok
Planujesz podróż do Peru w 2026 roku? Pozostań w kontakcie w Limie, Cusco, Machu Picchu, Dolinie Świętej i Amazonii dzięki bezproblemowej eSIM. Dowiedz się, jak sprawdzić zgodność urządzenia, wybrać odpowiedni plan danych, zrozumieć zasięg w poszczególnych regionach i zdecydować między eSIM a lokalną kartą SIM. Odkryj, dlaczego przystępne eSIMy tylko z danymi od Roamify (od 2 USD) są idealne dla podróżnych, którzy chcą natychmiastowej aktywacji po przyjeździe, braku opłat roamingowych i niezawodnych danych mobilnych w całym Peru.
Marissa Ling 
eSIM dla Arabii Saudyjskiej: Jak pozostać w kontakcie jako odwiedzający w 2026 roku
Planujesz podróż do Arabii Saudyjskiej w 2026 roku? Omiń drogie roamingi i kolejki po karty SIM na lotnisku, korzystając z podróżnej eSIM. Ten przewodnik wyjaśnia kompatybilność eSIM, zasięg w STC, Mobily i Zain, dostępność 4G/5G w Rijadzie, Dżuddzie, Mekce, Medynie i AlUla, ile danych naprawdę potrzebujesz oraz krok po kroku, jak skonfigurować eSIM przed wylotem. Porównaj wiodących dostawców, takich jak Roamify, Airalo i Holafly, dowiedz się o używaniu VPN i aplikacji (WhatsApp, Telegram, media społecznościowe) oraz uzyskaj praktyczne wskazówki, jak pozostać w kontakcie podczas Hajj, Umrah, podróży służbowych lub rekreacyjnych w Arabii Saudyjskiej.
Michael Harbour
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 Bogle