Roamify eSIM API Perubahan Penting
Donald Bogle
June 9, 2026 22:20
Kami meluncurkan serangkaian pembaruan API yang membawa endpoint baru, fungsionalitas yang diperluas, dan beberapa perubahan yang perlu Anda ketahui sebelum memperbarui integrasi Anda.
⚠️ Perubahan yang Mengganggu — Dapatkan Paket eSIM #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Respons sekarang dipaginasi #
Endpoint ini sekarang mengembalikan hasil yang dipaginasi alih-alih semua paket dalam satu respons. Jika integrasi Anda mengambil paket tanpa parameter paginasi, Anda mungkin hanya menerima halaman pertama dari hasil.
Tindakan diperlukan: Perbarui integrasi Anda untuk menangani respons yang dipaginasi menggunakan parameter kueri page dan pageSize.
| Parameter | Tipe | Default | Deskripsi |
|---|---|---|---|
| page | string | 1 | Nomor halaman untuk diambil. |
| pageSize | string | 50 | Jumlah hasil per halaman. |
Untuk mengambil semua paket, iterasi melalui halaman sampai respons mengembalikan hasil yang lebih sedikit dari pageSize.
2. country dan countryCode sekarang memiliki arti yang berbeda #
Sebelumnya, bidang ini mungkin telah digunakan secara bergantian. Sekarang mereka memiliki tujuan yang berbeda dan keduanya harus menggunakan nilai yang bersumber dari GET /api/esim/countries endpoint — string sembarangan tidak lagi diterima.
| Parameter | Nilai yang diterima | Sumber |
|---|---|---|
| negara | Nama lengkap negara | field nama dari Country API |
| countryCode | kode negara ISO | field kode dari Country API |
Tindakan diperlukan: Jika Anda saat ini mengirimkan string negara teks bebas, perbarui integrasi Anda untuk terlebih dahulu memanggil GET /api/esim/countries dan gunakan nilai name atau code dari respons.
Endpoint Baru #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Mengembalikan daftar semua negara yang didukung oleh Roamify eSIM. Gunakan nilai name dan code dari respons ini sebagai input filter saat melakukan kueri GET /api/esim/packages.
parameter filter opsional tersedia dengan geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Kirim pesan SMS langsung ke eSIM.
| Nama | Tipe | Diperlukan | Deskripsi |
|---|---|---|---|
| iccid | string | required | ICCID dari eSIM untuk mengirim SMS. |
| message | string | required | Konten pesan yang akan dikirim. |
Updated Endpoints #
POST /api/esim/apply — startDate sekarang didukung #
Sebuah startDate field opsional baru telah ditambahkan ke endpoint Generate eSIM Profile. Untuk subset kecil dari paket (~30 dari 28,000+), field ini adalah required.
Anda dapat mengidentifikasi paket-paket ini dengan memeriksa apakah requirements.travelDate adalah true dalam objek paket. Jika diperlukan dan tidak disediakan, permintaan pembuatan profil akan gagal.
| Nama | Tipe | Diperlukan | Deskripsi |
|---|---|---|---|
| startDate | string | kondisional | Tanggal mulai perjalanan dalam format ISO 8601. Diperlukan jika requirements.travelDate adalah true. |
Pengingat timeout
Referensi API Lengkap #
Dokumentasi lengkap tersedia di docs.getroamify.com.
Jika Anda memiliki pertanyaan atau memerlukan bantuan untuk memperbarui integrasi Anda, hubungi tim dukungan mitra kami.
Paket tujuan eSIM terkait
Pertanyaan yang sering diajukan
- Apa yang akan saya pelajari di Roamify eSIM API Perubahan Penting?
- Anda akan mempelajari cara kerja aktivasi eSIM, cara membandingkan paket data, dan langkah penyiapan mana yang paling penting sebelum dan selama perjalanan Anda.
- Bagaimana cara memilih paket eSIM yang tepat untuk Jepang?
- Sesuaikan rencana Anda dengan lama perjalanan, perkiraan penggunaan data harian, kebutuhan hotspot, dan kualitas jaringan di tujuan Anda. Kunjungan singkat biasanya membutuhkan lebih sedikit data, sedangkan pekerjaan jarak jauh dan panggilan video membutuhkan lebih banyak data.
- Di mana saya dapat membeli paket eSIM perjalanan untuk Jepang dan Thailand?
- Gunakan tautan tujuan dalam panduan ini untuk langsung membuka halaman negara Roamify, membandingkan opsi paket, dan menyelesaikan pembayaran sebelum keberangkatan.