Roamify eSIM API Brytande Ändringar
Donald Bogle
June 9, 2026 22:20
Vi rullar ut en uppsättning API-uppdateringar som ger nya slutpunkter, utökad funktionalitet och några ändringar som du bör vara medveten om innan du uppdaterar din integration.
⚠️ Brytande ändringar — Få eSIM-paket #
Slutpunkt: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Svar är nu paginerat #
Denna slutpunkt returnerar nu paginerade resultat istället för alla paket i ett enda svar. Om din integration hämtar paket utan pagineringsparametrar kan det hända att du bara får den första sidan av resultaten.
Åtgärd krävs: Uppdatera din integration för att hantera paginerade svar med hjälp av page och pageSize frågeparametrar.
| Parameter | Typ | Standard | Beskrivning |
|---|---|---|---|
| sida | sträng | 1 | Sidanummer att hämta. |
| sidstorlek | sträng | 50 | Antal resultat per sida. |
För att hämta alla paket, iterera genom sidor tills svaret returnerar färre resultat än din sidstorlek.
2. land och landskod har nu distinkta betydelser #
Tidigare kunde dessa fält ha använts omväxlande. De har nu olika syften och båda måste använda värden hämtade från den GET /api/esim/countries endpoint — godtyckliga strängar accepteras inte längre.
| Parameter | Accepterat värde | Källa |
|---|---|---|
| land | Fullständigt landsnamn | namnfält från Country API |
| landskod | ISO landskod | kodfält från Country API |
Åtgärd krävs: Om du för närvarande skickar fritekst landssträngar, uppdatera din integration för att först anropa GET /api/esim/countries och använd name eller code värdena från svaret.
Nya slutpunkter #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Returnerar en lista över alla länder som stöds av Roamify eSIM. Använd name och code värdena från detta svar som filterinmatningar när du frågar GET /api/esim/packages.
valfritt filterparameter tillgänglig med geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Skicka ett SMS-meddelande direkt till en eSIM.
| Namn | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| iccid | sträng | obligatorisk | ICCID för eSIM att skicka SMS till. |
| meddelande | sträng | obligatorisk | Innehållet i meddelandet som ska skickas. |
Uppdaterade slutpunkter #
POST /api/esim/apply — startDate nu stöds #
Ett nytt valfritt startDate fält har lagts till i Generera eSIM-profil slutpunkten. För en liten delmängd av paket (~30 av 28,000+), är detta fält obligatoriskt.
Du kan identifiera dessa paket genom att kontrollera om requirements.travelDate är sant i paketobjektet. Om det krävs och inte tillhandahålls kommer begäran om profilgenerering att misslyckas.
| Namn | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
| startDate | sträng | villkorlig | Resans startdatum i ISO 8601-format. Obligatoriskt om requirements.travelDate är sant. |
Timeout-påminnelse
Full API-referens #
Full dokumentation finns på docs.getroamify.com.
Om du har några frågor eller behöver hjälp med att uppdatera din integration, kontakta vårt partnersupportteam.
Relaterade eSIM-destinationsplaner
Vanliga frågor
- Vad kommer jag att lära mig i Roamify eSIM API Brytande Ändringar?
- Du kommer att lära dig hur eSIM-aktivering fungerar, hur du jämför dataplaner och vilka inställningssteg som betyder mest före och under din resa.
- Hur väljer jag rätt eSIM-abonnemang för Japan?
- Matcha din plan med resans längd, förväntad daglig dataanvändning, behov av hotspot och nätverkskvalitet på din destination. Korta vistelser kräver vanligtvis mindre data, medan fjärrarbete och videosamtal behöver mer.
- Var kan jag köpa eSIM-resor för Japan och Thailand?
- Använd destinationslänkarna i den här guiden för att gå direkt till Roamifys landssidor, jämföra planalternativ och slutföra kassan före avresa.