Roamify eSIM API Změny
Donald Bogle
June 9, 2026 22:20
Uvolňujeme sadu aktualizací API, které přinášejí nové koncové body, rozšířenou funkčnost a několik změn, o kterých byste měli vědět před aktualizací vaší integrace.
⚠️ Zásadní změny — Získejte eSIM balíčky #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Odpověď je nyní stránkovaná #
Tento endpoint nyní vrací stránkované výsledky místo všech balíčků v jedné odpovědi. Pokud vaše integrace načítá balíčky bez parametrů stránkování, můžete dostávat pouze první stránku výsledků.
Akce vyžadována: Aktualizujte svou integraci, aby zpracovávala stránkované odpovědi pomocí page a pageSize dotazových parametrů.
| Parametr | Typ | Výchozí | Popis |
|---|---|---|---|
| stránka | řetězec | 1 | Číslo stránky k načtení. |
| velikostStránky | řetězec | 50 | Počet výsledků na stránku. |
Chcete-li načíst všechny balíčky, procházejte stránky, dokud odpověď nevrátí méně výsledků než vaše velikostStránky.
2. země a countryCode nyní mají odlišné významy #
Dříve mohly být tyto pole používány zaměnitelně. Nyní slouží různým účelům a oba musí používat hodnoty získané z GET /api/esim/countries koncového bodu — libovolné řetězce již nejsou akceptovány.
| Parametr | Přijatá hodnota | Zdroj |
|---|---|---|
| země | Celý název země | pole name z API země |
| countryCode | ISO kód země | pole kódu z API země |
Akce vyžadována: Pokud aktuálně předáváte volné textové řetězce země, aktualizujte svou integraci tak, aby nejprve zavolala GET /api/esim/countries a použila name nebo code hodnoty z odpovědi.
Nové koncové body #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Vrací seznam všech zemí podporovaných Roamify eSIM. Použijte name a kód hodnoty z této odpovědi jako vstupy filtru při dotazování GET /api/esim/packages.
volitelný filtr parametr dostupný s geografie
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Odeslat SMS zprávu přímo na eSIM.
| Název | Typ | Povinné | Popis |
|---|---|---|---|
| iccid | řetězec | povinné | ICCID eSIM, na který se má SMS poslat. |
| zpráva | řetězec | povinné | Obsah zprávy, který se má poslat. |
Aktualizované koncové body #
POST /api/esim/apply — startDate nyní podporováno #
Bylo přidáno nové volitelné startDate pole do koncového bodu pro generování profilu eSIM. Pro malou skupinu balíčků (~30 z 28 000+), je toto pole povinné.
Tyto balíčky můžete identifikovat tím, že zkontrolujete, zda je requirements.travelDate nastaveno na true v objektu balíčku. Pokud je to vyžadováno a není poskytnuto, žádost o generování profilu selže.
| Název | Typ | Požadováno | Popis |
|---|---|---|---|
| startDate | řetězec | podmínkový | Datum začátku cesty ve formátu ISO 8601. Požadováno, pokud je requirements.travelDate pravda. |
Připomenutí časového limitu
Úplná API reference #
Úplná dokumentace je k dispozici na docs.getroamify.com.
Pokud máte jakékoli dotazy nebo potřebujete pomoc s aktualizací vaší integrace, obraťte se na náš tým podpory partnerů.
Související plány destinace eSIM
Často kladené otázky
- Co se naučím v článku Roamify eSIM API Změny?
- Dozvíte se, jak funguje aktivace eSIM, jak porovnávat datové tarify a které kroky nastavení jsou nejdůležitější před a během cesty.
- Jak si mohu vybrat správný tarif eSIM pro Japonsko?
- Přizpůsobte svůj plán délce cesty, očekávanému dennímu využití dat, potřebám hotspotu a kvalitě sítě ve vaší destinaci. Krátké pobyty obvykle vyžadují méně dat, zatímco vzdálená práce a videohovory potřebují více.
- Kde si mohu koupit cestovní tarify eSIM pro země Japonsko a Thajsko?
- Pomocí odkazů na cíl v tomto průvodci přejděte přímo na stránky zemí Roamify, porovnejte možnosti plánu a dokončete platbu před odjezdem.