Roamify eSIM API Wijzigingen die Alles Veranderen
Donald Bogle
June 9, 2026 22:20
We rollen een reeks API-updates uit die nieuwe eindpunten, uitgebreide functionaliteit en een paar wijzigingen met zich meebrengen waar je je bewust van wilt zijn voordat je je integratie bijwerkt.
⚠️ Brekende Wijzigingen — Verkrijg eSIM Pakketten #
Eindpunt: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. De respons is nu gepagineerd #
Dit eindpunt retourneert nu gepageerde resultaten in plaats van alle pakketten in één enkele respons. Als je integratie pakketten zonder pagineringparameters ophaalt, ontvang je mogelijk alleen de eerste pagina met resultaten.
Actie vereist: Werk je integratie bij om gepagineerde responsen te verwerken met behulp van de pagina en paginaGrootte queryparameters.
| Parameter | Type | Standaard | Beschrijving |
|---|---|---|---|
| pagina | teken | 1 | Paginanummer om op te halen. |
| paginaGrootte | teken | 50 | Aantal resultaten per pagina. |
Om alle pakketten op te halen, doorloop pagina's totdat de reactie minder resultaten teruggeeft dan je paginaGrootte.
2. land en countryCode hebben nu verschillende betekenissen #
Eerder konden deze velden door elkaar worden gebruikt. Ze dienen nu verschillende doelen en beiden moeten waarden gebruiken die afkomstig zijn van de GET /api/esim/countries eindpunt — willekeurige strings worden niet langer geaccepteerd.
| Parameter | Geaccepteerde waarde | Bron |
|---|---|---|
| land | Volledige landnaam | naam veld van de Country API |
| countryCode | ISO landcode | code veld van de Country API |
Actie vereist: Als je momenteel vrije tekst landstrings doorgeeft, werk dan je integratie bij om eerst aan te roepen GET /api/esim/countries en gebruik de name of code waarden uit de respons.
Nieuwe eindpunten #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Geeft een lijst van alle landen die door Roamify eSIM worden ondersteund. Gebruik de name en code waarden uit deze reactie als filterinvoer bij het opvragen GET /api/esim/packages.
optionele filterparameter beschikbaar met geografie
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Stuur een SMS-bericht rechtstreeks naar een eSIM.
| Naam | Type | Verplicht | Beschrijving |
|---|---|---|---|
| iccid | string | vereist | Het ICCID van de eSIM waar de SMS naartoe gestuurd moet worden. |
| bericht | string | vereist | De inhoud van het te verzenden bericht. |
Bijgewerkte Eindpunten #
POST /api/esim/apply — startDate nu ondersteund #
Er is een nieuw optioneel startDate veld toegevoegd aan de Generate eSIM Profile endpoint. Voor een klein aantal pakketten (~30 van de 28.000+), is dit veld vereist.
Je kunt deze pakketten identificeren door te controleren of requirements.travelDate is true in het pakketobject. Als het vereist is en niet is opgegeven, zal het verzoek om het profiel te genereren mislukken.
| Naam | Type | Vereist | Beschrijving |
|---|---|---|---|
| startDate | string | voorwaardelijk | Reisstartdatum in ISO 8601-formaat. Vereist als requirements.travelDate waar is. |
Timeout herinnering
Volledige API Referentie #
Volledige documentatie is beschikbaar op docs.getroamify.com.
Als je vragen hebt of hulp nodig hebt bij het bijwerken van je integratie, neem dan contact op met ons partnerondersteuningsteam.
Gerelateerde eSIM-bestemmingsplannen
Veelgestelde vragen
- Wat leer ik in Roamify eSIM API Wijzigingen die Alles Veranderen?
- U leert hoe eSIM-activering werkt, hoe u data-abonnementen kunt vergelijken en welke installatiestappen het belangrijkst zijn voor en tijdens uw reis.
- Hoe kies ik het juiste eSIM-abonnement voor Japan?
- Stem uw plan af op de reisduur, het verwachte dagelijkse datagebruik, de hotspotbehoeften en de netwerkkwaliteit op uw bestemming. Voor korte verblijven zijn doorgaans minder gegevens nodig, terwijl voor werken op afstand en videogesprekken meer nodig is.
- Waar kan ik eSIM-abonnementen voor reizen kopen voor Japan en Thailand?
- Gebruik de bestemmingslinks in deze gids om rechtstreeks naar de Roamify-landenpagina's te gaan, planopties te vergelijken en vóór vertrek af te rekenen.