Roamify eSIM API Promjene
Donald Bogle
June 9, 2026 22:20
Uvodimo niz ažuriranja API-ja koja donose nove krajnje točke, proširenu funkcionalnost i nekoliko promjena o kojima ćete htjeti biti obaviješteni prije ažuriranja svoje integracije.
⚠️ Prekidne promjene — Nabavite eSIM pakete #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Odgovor je sada paginiran #
Ova točka sada vraća paginirane rezultate umjesto svih paketa u jednom odgovoru. Ako vaša integracija dohvaća pakete bez parametara paginacije, možda primate samo prvu stranicu rezultata.
Akcija potrebna: Ažurirajte svoju integraciju da obrađuje paginirane odgovore koristeći page i pageSize upitne parametre.
| Parametar | Tip | Zadano | Opis |
|---|---|---|---|
| stranica | niz | 1 | Broj stranice za dohvat. |
| veličinaStranice | niz | 50 | Broj rezultata po stranici. |
Da biste dohvatili sve pakete, prolazite kroz stranice dok odgovor ne vrati manje rezultata nego vaša veličinaStranice.
2. država i countryCode sada imaju različita značenja #
Prethodno su se ova polja mogla koristiti naizmjenično. Sada imaju različite svrhe i oba moraju koristiti vrijednosti preuzete iz GET /api/esim/countries krajnje točke — proizvoljni nizovi više nisu prihvaćeni.
| Parametar | Prihvaćena vrijednost | Izvor |
|---|---|---|
| država | Puno ime države | ime polja iz Country API |
| countryCode | ISO kod države | polje koda iz Country API |
Potrebna radnja: Ako trenutno šaljete slobodne tekstualne nizove država, ažurirajte svoju integraciju da prvo pozove GET /api/esim/countries i koristite name ili code vrijednosti iz odgovora.
Nove točke pristupa #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Vraća popis svih zemalja koje podržava Roamify eSIM. Koristite name i kod vrijednosti iz ovog odgovora kao ulaze za filtriranje prilikom upita GET /api/esim/packages.
opcionalni parametar filtriranja dostupan s geografija
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Pošaljite SMS poruku izravno na eSIM.
| Ime | Tip | Obavezno | Opis |
|---|---|---|---|
| iccid | string | obavezno | ICCID eSIM-a na koji se šalje SMS. |
| poruka | string | obavezno | Sadržaj poruke za slanje. |
Ažurirani krajnji točke #
POST /api/esim/apply — startDate sada podržano #
Novi opcionalni startDate parametar je dodan u krajnju točku za generiranje eSIM profila. Za mali skup paketa (~30 od 28,000+), ovaj parametar je obavezan.
Ove pakete možete identificirati provjerom je li requirements.travelDate postavljeno na true u objektu paketa. Ako je potrebno i nije navedeno, zahtjev za generiranje profila će propasti.
| Ime | Tip | Obavezno | Opis |
|---|---|---|---|
| datumPočetka | string | uvjetno | Datum početka putovanja u ISO 8601 formatu. Obavezno ako je requirements.travelDate postavljeno na true. |
Podsjetnik na vrijeme
Potpuna API referenca #
Puna dokumentacija dostupna je na docs.getroamify.com.
Ako imate bilo kakvih pitanja ili trebate pomoć pri ažuriranju svoje integracije, obratite se našem timu za podršku partnerima.
Povezani eSIM odredišni planovi
Često postavljana pitanja
- Što ću naučiti u Roamify eSIM API Promjene?
- Naučit ćete kako funkcionira aktivacija eSIM-a, kako usporediti podatkovne pakete i koji su koraci postavljanja najvažniji prije i tijekom vašeg putovanja.
- Kako mogu odabrati pravi eSIM plan za Japan?
- Uskladite svoj plan s duljinom putovanja, očekivanom dnevnom potrošnjom podataka, potrebama žarišne točke i kvalitetom mreže na vašem odredištu. Za kratke boravke obično je potrebno manje podataka, dok je za rad na daljinu i videopozive potrebno više.
- Gdje mogu kupiti putne eSIM pakete za Japan i Tajland?
- Upotrijebite poveznice odredišta u ovom vodiču za izravni odlazak na Roamify stranice zemalja, usporedite opcije plana i dovršite odjavu prije polaska.