Roamify eSIM API Brydninger
Donald Bogle
June 9, 2026 22:20
Vi ruller et sæt API-opdateringer ud, der bringer nye endpoints, udvidet funktionalitet og et par ændringer, du skal være opmærksom på, før du opdaterer din integration.
⚠️ Brydende ændringer — Få eSIM-pakker #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Svar er nu pagineret #
Dette endpoint returnerer nu paginerede resultater i stedet for alle pakker i et enkelt svar. Hvis din integration henter pakker uden pagineringsparametre, modtager du muligvis kun den første side af resultater.
Handling kræves: Opdater din integration til at håndtere paginerede svar ved hjælp af page og pageSize forespørgselsparametre.
| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
| side | streng | 1 | Sidenummer der skal hentes. |
| sideStørrelse | streng | 50 | Antal resultater pr. side. |
For at hente alle pakker, skal du iterere gennem sider, indtil svaret returnerer færre resultater end din sideStørrelse.
2. land og landekode har nu forskellige betydninger #
Tidligere kunne disse felter være blevet brugt ombytteligt. De tjener nu forskellige formål, og begge skal bruge værdier hentet fra den GET /api/esim/countries endpoint — vilkårlige strenge accepteres ikke længere.
| Parameter | Accepteret værdi | Kilde |
|---|---|---|
| land | Fuldt land navn | navnefeltet fra Country API |
| landekode | ISO landekode | kodefeltet fra Country API |
Handling krævet: Hvis du i øjeblikket sender fritekst landstrenge, opdater din integration til først at kalde GET /api/esim/countries og brug name eller code værdierne fra svaret.
Nye Endpoints #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Returnerer en liste over alle lande, der understøttes af Roamify eSIM. Brug name og code værdierne fra dette svar som filterinput, når du forespørger GET /api/esim/packages.
valgfri filterparameter tilgængelig med geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Send en SMS-besked direkte til en eSIM.
| Navn | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| iccid | streng | påkrævet | ICCID'en for eSIM'en, som SMS'en skal sendes til. |
| besked | streng | påkrævet | Indholdet af beskeden, der skal sendes. |
Opdaterede Endepunkter #
POST /api/esim/apply — startDate nu understøttet #
Et nyt valgfrit startDate felt er blevet tilføjet til Generer eSIM-profil endpointet. For et lille udvalg af pakker (~30 ud af 28.000+), er dette felt påkrævet.
Du kan identificere disse pakker ved at tjekke om requirements.travelDate er sand i pakkeobjektet. Hvis det er nødvendigt og ikke angivet, vil anmodningen om profilgenerering fejle.
| Navn | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| startDate | streng | betinget | Rejse startdato i ISO 8601-format. Påkrævet hvis requirements.travelDate er sand. |
Timeout påmindelse
Fuldt API-referencen #
Fuld dokumentation er tilgængelig på docs.getroamify.com.
Hvis du har spørgsmål eller har brug for hjælp til at opdatere din integration, så kontakt vores partner supportteam.
Relaterede eSIM-destinationsplaner
Ofte stillede spørgsmål
- Hvad lærer jeg i Roamify eSIM API Brydninger?
- Du vil lære, hvordan eSIM-aktivering fungerer, hvordan du sammenligner dataplaner, og hvilke opsætningstrin der betyder mest før og under din rejse.
- Hvordan vælger jeg det rigtige eSIM-abonnement for Japan?
- Match din plan med rejselængde, forventet daglig databrug, behov for hotspots og netværkskvalitet på din destination. Korte ophold kræver normalt mindre data, mens fjernarbejde og videoopkald kræver mere.
- Hvor kan jeg købe eSIM-rejseplaner for Japan og Thailand?
- Brug destinationslinkene i denne guide til at gå direkte til Roamify-landesider, sammenligne abonnementsmuligheder og fuldføre kassen før afgang.