Roamify eSIM API Muutokset
Donald Bogle
June 9, 2026 22:20
Julkaisemme joukon API-päivityksiä, jotka tuovat uusia päätepisteitä, laajennettua toiminnallisuutta ja muutamia muutoksia, joista sinun kannattaa olla tietoinen ennen integraatiosi päivittämistä.
⚠️ Rikkovia muutoksia — Hanki eSIM-paketit #
Päätepiste: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Vastaus on nyt sivutettu #
Tämä päätepiste palauttaa sivutettuja tuloksia sen sijaan, että kaikki paketit palautettaisiin yhdessä vastauksessa. Jos integraatiosi noutaa paketteja ilman sivutuspainotuksia, saatat saada vain ensimmäisen sivun tuloksista.
Toimenpide vaaditaan: Päivitä integraatiosi käsittelemään sivutettuja vastauksia käyttäen page ja pageSize kyselyparametreja.
| Parametri | Tyyppi | Oletusarvo | Kuvaus |
|---|---|---|---|
| sivu | merkkijono | 1 | Sivunumero, joka haetaan. |
| sivukoko | merkkijono | 50 | Tulosten määrä per sivu. |
Kaikkien pakettien hakemiseksi, käy läpi sivuja kunnes vastaus palauttaa vähemmän tuloksia kuin sinun sivukoko.
2. maa ja maakoode ovat nyt erillisiä merkityksiä #
Aiemmin näitä kenttiä saatettiin käyttää keskenään vaihdettavasti. Ne palvelevat nyt eri tarkoituksia ja molempien on käytettävä arvoja, jotka on saatu GET /api/esim/countries päätepiste — satunnaisia merkkijonoja ei enää hyväksytä.
| Parametri | Hyväksyttävä arvo | Lähde |
|---|---|---|
| maa | Koko maan nimi | name-kenttä Country API:sta |
| countryCode | ISO-maakoodi | code-kenttä Country API:sta |
Vaaditaan toimenpiteitä: Jos lähetät tällä hetkellä vapaamuotoisia maan merkkijonoja, päivitä integraatiosi kutsumaan ensin GET /api/esim/countries ja käytä name tai code arvoja vastauksesta.
Uudet päätepisteet #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Palauttaa luettelon kaikista maista, joita Roamify eSIM tukee. Käytä tämän vastauksen name ja code arvoja suodatinparametreina kyselyssä GET /api/esim/packages.
valinnainen suodatinparametri saatavilla geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Lähetä SMS-viesti suoraan eSIM:lle.
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
| iccid | merkkijono | vaaditaan | eSIM:n ICCID, johon SMS lähetetään. |
| viesti | merkkijono | vaaditaan | Lähetettävän viestin sisältö. |
Päivitetyt päätepisteet #
POST /api/esim/apply — alkamispäivämäärä nyt tuettu #
Uusi valinnainen alkamispäivämäärä-kenttä on lisätty Generate eSIM Profile -päätepisteeseen. Pienelle osalle paketteja (~30 28,000+:sta) tämä kenttä on vaadittu.
Voit tunnistaa nämä paketit tarkistamalla, onko vaatimukset.matkustuspäivämäärä on totta paketin objektissa. Jos vaaditaan eikä ole annettu, profiilin luontipyyntö epäonnistuu.
| Nimi | Tyyppi | Vaaditaan | Kuvaus |
|---|---|---|---|
| aloitusPäivämäärä | merkkijono | ehdollinen | Matkan aloituspäivämäärä ISO 8601 -muodossa. Vaaditaan, jos vaatimukset.matkapäivämäärä on tosi. |
Aikakatkaisu muistutus
Koko API-viite #
Koko dokumentaatio on saatavilla osoitteessa docs.getroamify.com.
Jos sinulla on kysymyksiä tai tarvitset apua integraatiosi päivittämisessä, ota yhteyttä kumppanitukitiimiimme.
Aiheeseen liittyvät eSIM-kohdesuunnitelmat
Usein kysytyt kysymykset
- Mitä opin artikkelista Roamify eSIM API Muutokset?
- Opit kuinka eSIM-aktivointi toimii, kuinka vertailla datapaketteja ja mitkä asennusvaiheet ovat tärkeimpiä ennen matkaasi ja sen aikana.
- Kuinka valitsen oikean eSIM-sopimuksen maalle Japani?
- Yhdistä suunnitelmasi matkan pituuteen, odotettuun päivittäiseen tiedonsiirtoon, hotspot-tarpeisiin ja määränpääsi verkon laatuun. Lyhyet oleskelu vaativat yleensä vähemmän dataa, kun taas etätyö ja videopuhelut tarvitsevat enemmän.
- Mistä voin ostaa eSIM-matkapaketteja maille Japani ja Thaimaa?
- Käytä tämän oppaan kohdelinkkejä siirtyäksesi suoraan Roamify-maasivuille, vertaillaksesi suunnitelmavaihtoehtoja ja suorittaaksesi kassan ennen lähtöä.