Mga Pagbabago sa Roamify eSIM API
Donald Bogle
June 9, 2026 22:20
Naglalabas kami ng isang set ng mga update sa API na nagdadala ng mga bagong endpoint, pinalawak na functionality, at ilang mga pagbabago na nais mong malaman bago i-update ang iyong integration.
⚠️ Mga Pagbabagong Nakakasira — Kumuha ng mga eSIM Package #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Ang tugon ay naka-paginate na ngayon #
Ang endpoint na ito ay nagbabalik ngayon ng mga naka-paginate na resulta sa halip na lahat ng package sa isang solong tugon. Kung ang iyong integration ay kumukuha ng mga package nang walang mga parameter ng pagination, maaaring tumanggap ka lamang ng unang pahina ng mga resulta.
Kailangan ng aksyon: I-update ang iyong integration upang hawakan ang mga naka-paginate na tugon gamit ang page at pageSize na mga query parameter.
| Parameter | Uri | Default | Paglalarawan |
|---|---|---|---|
| pahina | string | 1 | Numero ng pahina na kukunin. |
| pageSize | string | 50 | Bilang ng mga resulta bawat pahina. |
Upang makuha ang lahat ng mga pakete, ulitin ang mga pahina hanggang ang tugon ay magbalik ng mas kaunting resulta kaysa sa iyong pageSize.
2. bansa at countryCode ay may magkakaibang kahulugan na ngayon #
Dati, ang mga patlang na ito ay maaaring ginamit na magkakapareho. Ngayon, nagsisilbi silang may iba't ibang layunin at pareho ay dapat gumamit ng mga halaga na nakuha mula sa GET /api/esim/countries endpoint — hindi na tinatanggap ang mga arbitrary na string.
| Parameter | Tinanggap na halaga | Pinagmulan |
|---|---|---|
| bansa | Buong pangalan ng bansa | name field mula sa Country API |
| countryCode | ISO country code | code field mula sa Country API |
Kailangan ng aksyon: Kung kasalukuyan kang nagpapasa ng free-text na mga string ng bansa, i-update ang iyong integration upang unang tawagan ang GET /api/esim/countries at gamitin ang name o code na mga halaga mula sa tugon.
Mga Bagong Endpoint #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Nagbabalik ng listahan ng lahat ng bansa na sinusuportahan ng Roamify eSIM. Gamitin ang name at code na mga halaga mula sa tugon na ito bilang mga filter input kapag nag-query ng GET /api/esim/packages.
opsyonal na parameter ng filter na available sa geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Magpadala ng SMS na mensahe nang direkta sa isang eSIM.
| Pangalan | Uri | Kinakailangan | Paglalarawan |
|---|---|---|---|
| iccid | string | required | Ang ICCID ng eSIM na padadalhan ng SMS. |
| message | string | required | Ang nilalaman ng mensahe na ipapadala. |
Updated Endpoints #
POST /api/esim/apply — startDate ngayon ay sinusuportahan #
Isang bagong opsyonal na startDate na patlang ang idinagdag sa Generate eSIM Profile endpoint. Para sa isang maliit na subset ng mga package (~30 sa 28,000+), ang patlang na ito ay required.
Maaari mong tukuyin ang mga package na ito sa pamamagitan ng pag-check kung ang requirements.travelDate ay true sa package object. Kung kinakailangan at hindi ibinigay, mabibigo ang kahilingan sa pagbuo ng profile.
| Pangalan | Uri | Kinakailangan | Paglalarawan |
|---|---|---|---|
| startDate | string | conditional | Petsa ng pagsisimula ng paglalakbay sa ISO 8601 na format. Kinakailangan kung totoo ang requirements.travelDate. |
Timeout reminder
Full API Reference #
Buong dokumentasyon ay available sa docs.getroamify.com.
Kung mayroon kang anumang mga katanungan o kailangan ng tulong sa pag-update ng iyong integration, makipag-ugnayan sa aming partner support team.
Mga kaugnay na plano sa patutunguhan ng eSIM
Mga madalas itanong
- Ano ang matututunan ko sa Mga Pagbabago sa Roamify eSIM API?
- Malalaman mo kung paano gumagana ang eSIM activation, kung paano ihambing ang mga data plan, at kung aling mga hakbang sa pag-setup ang pinakamahalaga bago at sa panahon ng iyong biyahe.
- Paano ko pipiliin ang tamang eSIM plan para sa Hapon?
- Itugma ang iyong plano sa haba ng biyahe, inaasahang pang-araw-araw na paggamit ng data, mga pangangailangan sa hotspot, at kalidad ng network sa iyong patutunguhan. Ang mga maikling pananatili ay karaniwang nangangailangan ng mas kaunting data, habang ang malayuang trabaho at mga video call ay nangangailangan ng higit pa.
- Saan ako makakabili ng mga travel eSIM plan para sa Hapon at Tailand?
- Gamitin ang mga patutunguhang link sa gabay na ito para direktang pumunta sa Roamify na mga page ng bansa, ihambing ang mga opsyon sa plano, at kumpletuhin ang pag-checkout bago umalis.