Roamify eSIM API Perubahan Penting
Donald Bogle
June 9, 2026 22:20
Kami melancarkan satu set kemas kini API yang membawa titik akhir baru, fungsi yang diperluas, dan beberapa perubahan yang perlu anda ketahui sebelum mengemas kini integrasi anda.
⚠️ Perubahan Patah — Dapatkan Pakej eSIM #
Titik akhir: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Respons kini dipaginasikan #
Titik akhir ini kini mengembalikan hasil yang dipaginasikan bukannya semua pakej dalam satu respons. Jika integrasi anda mengambil pakej tanpa parameter paginasi, anda mungkin hanya menerima halaman pertama hasil.
Tindakan diperlukan: Kemas kini integrasi anda untuk mengendalikan respons yang dipaginasikan menggunakan parameter pertanyaan page dan pageSize.
| Parameter | Jenis | Default | Description |
|---|---|---|---|
| page | string | 1 | Nombor halaman untuk diambil. |
| pageSize | string | 50 | Bilangan hasil per halaman. |
Untuk mengambil semua pakej, ulangi melalui halaman sehingga respons mengembalikan hasil yang lebih sedikit daripada pageSize.
2. country dan countryCode kini mempunyai makna yang berbeza #
Sebelum ini, medan ini mungkin telah digunakan secara bergantian. Kini mereka berfungsi untuk tujuan yang berbeza dan kedua-duanya mesti menggunakan nilai yang diperoleh dari GET /api/esim/countries endpoint — rentetan sewenang-wenangnya tidak lagi diterima.
| Parameter | Nilai diterima | Sumber |
|---|---|---|
| negara | Nama penuh negara | medan nama dari API Negara |
| countryCode | kod negara ISO | medan kod dari API Negara |
Tindakan diperlukan: Jika anda sedang menghantar rentetan negara teks bebas, kemas kini integrasi anda untuk memanggil terlebih dahulu GET /api/esim/countries dan gunakan nilai name atau code dari respons.
Titik Akhir Baru #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Mengembalikan senarai semua negara yang disokong oleh Roamify eSIM. Gunakan nilai name dan code dari respons ini sebagai input penapis apabila menyoal GET /api/esim/packages.
parameter penapis pilihan tersedia dengan geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Hantar mesej SMS terus kepada eSIM.
| Nama | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
| iccid | string | required | ICCID eSIM untuk menghantar SMS. |
| message | string | required | Kandungan mesej untuk dihantar. |
Titik Akhir Dikemas kini #
POST /api/esim/apply — startDate kini disokong #
Satu startDate pilihan baharu telah ditambahkan ke titik akhir Hasil Profil eSIM. Untuk subset kecil pakej (~30 daripada 28,000+), medan ini adalah required.
Anda boleh mengenal pasti pakej ini dengan memeriksa jika requirements.travelDate adalah true dalam objek pakej. Jika diperlukan dan tidak disediakan, permintaan penjanaan profil akan gagal.
| Nama | Jenis | Diperlukan | Penerangan |
|---|---|---|---|
| tarikhMula | string | bersyarat | Tarikh mula perjalanan dalam format ISO 8601. Diperlukan jika requirements.travelDate adalah benar. |
Peringatan masa tamat
Rujukan API Penuh #
Dokumentasi penuh boleh didapati di docs.getroamify.com.
Jika anda mempunyai sebarang soalan atau memerlukan bantuan untuk mengemas kini integrasi anda, hubungi pasukan sokongan rakan kongsi kami.
Pelan destinasi eSIM yang berkaitan
Soalan lazim
- Apakah yang akan saya pelajari dalam Roamify eSIM API Perubahan Penting?
- Anda akan mempelajari cara pengaktifan eSIM berfungsi, cara membandingkan pelan data dan langkah persediaan yang paling penting sebelum dan semasa perjalanan anda.
- Bagaimanakah cara saya memilih pelan eSIM yang betul untuk Jepun?
- Padankan rancangan anda dengan panjang perjalanan, jangkaan penggunaan data harian, keperluan tempat liputan dan kualiti rangkaian di destinasi anda. Penginapan singkat biasanya memerlukan lebih sedikit data, manakala kerja jauh dan panggilan video memerlukan lebih banyak.
- Di manakah saya boleh membeli pelan eSIM perjalanan untuk Jepun dan Thailand?
- Gunakan pautan destinasi dalam panduan ini untuk pergi terus ke halaman negara Roamify, bandingkan pilihan pelan dan lengkapkan pembayaran sebelum berlepas.