Roamify eSIM API Brytningsendringer
Donald Bogle
June 9, 2026 22:20
Vi ruller ut et sett med API-oppdateringer som bringer nye endepunkter, utvidet funksjonalitet, og noen endringer du bør være klar over før du oppdaterer integrasjonen din.
⚠️ Brytende endringer — Få eSIM-pakker #
Endepunkt: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Responsen er nå paginert #
Dette endepunktet returnerer nå paginert resultat i stedet for alle pakker i en enkelt respons. Hvis integrasjonen din henter pakker uten pagineringsparametere, kan det hende du bare mottar den første siden med resultater.
Handling kreves: Oppdater integrasjonen din for å håndtere paginerte svar ved å bruke page og pageSize spørringsparametere.
| Parameter | Type | Standard | Beskrivelse |
|---|---|---|---|
| side | streng | 1 | Sidenummer for å hente. |
| sideStørrelse | streng | 50 | Antall resultater per side. |
For å hente alle pakker, iterer gjennom sider til svaret returnerer færre resultater enn din sideStørrelse.
2. land og landKode har nå distinkte betydninger #
Tidligere kunne disse feltene ha blitt brukt om hverandre. De tjener nå forskjellige formål og begge må bruke verdier hentet fra den GET /api/esim/countries endpoint — vilkårlige strenger aksepteres ikke lenger.
| Parameter | Akseptert verdi | Kilde |
|---|---|---|
| land | Fullt landsnavn | navn felt fra Country API |
| landskode | ISO landskode | kode felt fra Country API |
Handling kreves: Hvis du for øyeblikket sender fritekst landsstrenger, oppdater integrasjonen din til først å kalle GET /api/esim/countries og bruk navn eller kode verdiene fra svaret.
Nye Endepunkter #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Returnerer en liste over alle land som støttes av Roamify eSIM. Bruk name og code verdiene fra dette svaret som filterinnput når du spør GET /api/esim/packages.
valgfri filterparameter tilgjengelig med geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Send en SMS-melding direkte til en eSIM.
| Navn | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
| iccid | string | required | ICCID-en til eSIM-en som SMS-en skal sendes til. |
| message | string | required | Innholdet i meldingen som skal sendes. |
Oppdaterte Endepunkter #
POST /api/esim/apply — startDate nå støttet #
Et nytt valgfritt startDate felt har blitt lagt til i Generer eSIM-profil-endepunktet. For et lite utvalg av pakker (~30 av 28,000+), er dette feltet required.
Du kan identifisere disse pakkene ved å sjekke om requirements.travelDate er true i pakkeobjektet. Hvis det er nødvendig og ikke oppgitt, vil forespørselen om profilgenerering mislykkes.
| Navn | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
| startDate | streng | betinget | Reisedato i ISO 8601-format. Påkrevd hvis kravene.travelDate er sanne. |
Timeout-påminnelse
Full API-referanse #
Full dokumentasjon er tilgjengelig på docs.getroamify.com.
Hvis du har spørsmål eller trenger hjelp med å oppdatere integrasjonen din, ta kontakt med vårt partnerstøtteteam.
Relaterte eSIM-destinasjonsplaner
Ofte stilte spørsmål
- Hva vil jeg lære i Roamify eSIM API Brytningsendringer?
- Du vil lære hvordan eSIM-aktivering fungerer, hvordan du sammenligner dataplaner og hvilke oppsettstrinn som betyr mest før og under reisen.
- Hvordan velger jeg riktig eSIM-abonnement for Japan?
- Match planen din med reiselengde, forventet daglig databruk, behov for hotspot og nettverkskvalitet på destinasjonen. Korte opphold krever vanligvis mindre data, mens eksternt arbeid og videosamtaler trenger mer.
- Hvor kan jeg kjøpe eSIM-reiseplaner for Japan og Thailand?
- Bruk destinasjonslenkene i denne guiden for å gå direkte til Roamify-landssider, sammenligne planalternativer og fullføre utsjekking før avreise.