Roamify eSIM API Zmiany
Donald Bogle
June 9, 2026 22:20
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.
Powiązane plany docelowe eSIM
Często zadawane pytania
- Czego dowiem się z Roamify eSIM API Zmiany?
- 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.
- Jak wybrać odpowiedni plan eSIM dla Japonia?
- 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.
- Gdzie mogę kupić podróżne plany eSIM dla Japonia i Tajlandia?
- 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.