Roamify eSIM API Muutokset
Tutustu Roamifyn viimeisimpiin eSIM API -päivityksiin, mukaan lukien uudet sivutettu vastaukset GET /api/esim/packages, tiukempi maa- ja countryCode-validointi…
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.
Usein kysytyt kysymykset
Opit kuinka eSIM-aktivointi toimii, kuinka vertailla datapaketteja ja mitkä asennusvaiheet ovat tärkeimpiä ennen matkaasi ja sen aikana.
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.
Käytä tämän oppaan kohdelinkkejä siirtyäksesi suoraan Roamify-maasivuille, vertaillaksesi suunnitelmavaihtoehtoja ja suorittaaksesi kassan ennen lähtöä.
Suositut eSIM-paketit
Käsin valitut kohteet seuraavalle matkallesi.
Osta eSIM-sopimuksia Turkki
Osta eSIM-sopimuksia Thaimaa
Osta eSIM-sopimuksia Yhdistyneet arabiemiirikunnat
Osta eSIM-sopimuksia Singapore
Osta eSIM-sopimuksia Australia
Osta eSIM-sopimuksia MeksikoMatkalla uuteen paikkaan? Pysy yhteydessä heti laskeuduttuasi.
Edullista matkadataa yli 200 kohteeseen. Ei roaming-maksuja, ei piilokuluja, skannaa vain ja lähde.
Jatka lukemista
Kaikki artikkelit
eSIM Peru: Täydellinen yhteysopas vuodelle 2026
Suunnitteletko matkaa Peruunk vuonna 2026? Pysy yhteydessä Limassa, Cuzcossa, Machu Picchussa, Pyhässä laaksossa ja Amazonilla vaivattomalla eSIM:llä. Opi tarkistamaan laitteesi yhteensopivuus, valitsemaan oikea datasuunnitelma, ymmärtämään kattavuutta alueittain ja päättämään eSIM:n ja paikallisen SIM:n välillä. Opi, miksi Roamifyn edulliset, pelkästään datan sisältävät eSIM:t (alkaen 2 dollarista) ovat ihanteellisia matkailijoille, jotka haluavat välittömän aktivoinnin saapuessaan, ei roaming-maksuja ja luotettavaa mobiilidataa koko Perussa.
Marissa Ling 
eSIM Saudi-Arabiaan: Kuinka pysyä yhteydessä vierailijana vuonna 2026
Suunnitteletko matkaa Saudi-Arabiaan vuonna 2026? Vältä kalliit roaming-maksut ja lentokentän SIM-jonot käyttämällä matkailu eSIM:iä. Tämä opas selittää eSIM-yhteensopivuuden, kattavuuden STC:llä, Mobilyllä ja Zainilla, 4G/5G saatavuuden Riyadhissa, Jeddahissa, Mekassa, Medinassa ja AlUlassa, kuinka paljon dataa todella tarvitset, ja vaiheittaisen eSIM-asennuksen ennen lentoa. Vertaa johtavia palveluntarjoajia kuten Roamify, Airalo ja Holafly, opi VPN:n ja sovellusten käytöstä (WhatsApp, Telegram, sosiaalinen media) ja saa käytännön vinkkejä pysyäksesi yhteydessä sujuvasti Hajjissa, Umrahissa, liikematkalla tai vapaa-ajan matkalla Saudi-Arabiassa.
Michael Harbour
Roamify Partner Program: How to Earn Money Reselling eSIMs in 2026
Discover the Roamify Partner Program, a high-converting travel eSIM affiliate and reseller opportunity built for bloggers, comparison sites, travel agencies, and digital nomad communities. Promote data-only eSIMs from just $2 with coverage in 200+ countries, a 4.6 Trustpilot rating, top-ranked customer support, and a 5% discount code (ROAM5) to boost conversions. Apply in minutes at partner.getroamify.com and start earning commissions by recommending one of the cheapest, most reliable travel eSIM providers on the market.
Donald Bogle