Roamify eSIM API Breytingar
Donald Bogle
June 9, 2026 22:20
Við erum að koma með uppfærslur á API sem bjóða nýjar endapunkta, stækkaða virkni og nokkrar breytingar sem þú vilt vera meðvitaður um áður en þú uppfærir samþættingu þína.
⚠️ Breytingar sem brjóta samþættingu — Fá eSIM pakka #
Endapunktur: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Svar er núna síusett #
Þessi endapunktur skilar nú síusettum niðurstöðum í stað þess að skila öllum pakkunum í einu svari. Ef samþætting þín sækir pakka án síusettar, gætirðu aðeins verið að fá fyrstu síðu niðurstaðna.
Aðgerð krafist: Uppfærðu samþættingu þína til að meðhöndla síusett svör með page og pageSize fyrirspurnargildum.
| Fyrirspurnargildi | Tegund | Default | Lýsing |
|---|---|---|---|
| síða | strengur | 1 | Síðutala til að sækja. |
| pageSize | strengur | 50 | Fjöldi niðurstaðna á síðu. |
Til að sækja öll pakka, farðu í gegnum síður þar til svörin skila færri niðurstöðum en þín pageSize.
2. land og landakóði hafa nú mismunandi merkingar #
Áður voru þessi svæði kannski notuð samhliða. Þau þjónusta nú mismunandi tilgangi og bæði verða að nota gildi sem sótt eru frá GET /api/esim/countries endpoint — handahófsstrengir eru ekki lengur samþykktir.
| Parameter | Samþykkt gildi | Heimild |
|---|---|---|
| land | Heildar nafn lands | nafn reitinn úr Country API |
| landakóði | ISO landskóði | kóða reitinn úr Country API |
Aðgerð nauðsynleg: Ef þú ert að senda frjáls texta landsstrengir, uppfærðu samþættingu þína til að kalla fyrst GET /api/esim/countries og nota name eða code gildi úr svöruninni.
Nýjar endapunkta #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Skilar lista yfir öll lönd sem Roamify eSIM styður. Notaðu name og code gildi úr þessari svörun sem síu inntak þegar þú spyrð um GET /api/esim/packages.
valfrjáls síu breyta í boði með geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Sendu SMS skilaboð beint til eSIM.
| Nafn | Tegund | Krafist | Lýsing |
|---|---|---|---|
| iccid | strengur | nauðsynlegt | ICCID eSIM-innar sem á að senda SMS til. |
| skilaboð | strengur | nauðsynlegt | Innihald skilaboðanna sem á að senda. |
Uppfærðar Endapunktar #
POST /api/esim/apply — startDate nú studd #
Nýr valfrjáls startDate reitur hefur verið bætt við Generate eSIM Profile endapunktinn. Fyrir lítið úrtak af pakkningum (~30 af 28,000+), er þessi reitur nauðsynlegur.
Þú getur auðkennt þessar pakkningar með því að athuga hvort requirements.travelDate sé satt í pakkanum. Ef krafist er og ekki veitt, mun beiðni um prófílmyndun mistakast.
| Nafn | Tegund | Krafist | Lýsing |
|---|---|---|---|
| startDate | strengur | skilyrðislegt | Upphafsdagsetning ferðalags í ISO 8601 sniði. Krafist ef requirements.travelDate er satt. |
Tími áminningar
Heildar API Vísir #
Heildarskjölin eru aðgengileg á docs.getroamify.com.
Ef þú hefur einhverjar spurningar eða þarft aðstoð við að uppfæra samþættingu þína, hafðu samband við stuðningsteymi okkar fyrir samstarfsaðila.
Tengdar eSIM áfangastaðaáætlanir
Algengar spurningar
- Hvað mun ég læra í Roamify eSIM API Breytingar?
- Þú munt læra hvernig eSIM virkjun virkar, hvernig á að bera saman gagnaáætlanir og hvaða uppsetningarskref skipta mestu máli fyrir og meðan á ferð stendur.
- Hvernig vel ég réttu eSIM áskriftina fyrir Japan?
- Passaðu áætlun þína við lengd ferðar, væntanlega daglega gagnanotkun, þarfir netkerfis og netgæði á áfangastað. Stuttar dvöl þarf yfirleitt minna gagnamagn á meðan fjarvinna og myndsímtöl þurfa meira.
- Hvar get ég keypt eSIM ferðaáskriftir fyrir Japan og Taíland?
- Notaðu áfangastaðstenglana í þessari handbók til að fara beint á Roamify landssíður, bera saman áætlunarvalkosti og ganga frá útskráningu fyrir brottför.