Roamify eSIM API Kırılma Değişiklikleri
Donald Bogle
June 9, 2026 22:20
Yeni uç noktalar, genişletilmiş işlevsellik ve entegrasyonunuzu güncellemeden önce farkında olmanız gereken birkaç değişiklik getiren bir dizi API güncellemesi yayımlıyoruz.
⚠️ Kırıcı Değişiklikler — eSIM Paketlerini Alın #
Uç Nokta: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Yanıt artık sayfalara ayrılmış durumda #
Bu uç nokta artık sayfalara ayrılmış sonuçlar döndürüyor, tek bir yanıtta tüm paketler yerine. Entegrasyonunuz sayfalama parametreleri olmadan paketleri alıyorsa, yalnızca sonuçların ilk sayfasını alıyor olabilirsiniz.
Gerekli eylem: Sayfalara ayrılmış yanıtları işlemek için entegrasyonunuzu güncelleyin, sayfa ve sayfaBoyutu sorgu parametrelerini kullanarak.
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
| sayfa | dize | 1 | Alınacak sayfa numarası. |
| sayfaBoyutu | dize | 50 | Sayfa başına sonuç sayısı. |
Tüm paketleri almak için, yanıt sayfa başına sonuç sayısından daha az sonuç döndürene kadar sayfalar arasında yineleyin.sayfaBoyutu.
2. ülke ve ülkeKodu artık farklı anlamlara sahip #
Önceden bu alanlar birbirinin yerine kullanılabiliyordu. Artık farklı amaçlara hizmet ediyorlar ve her ikisi de kaynak değerleri kullanmalıdır GET /api/esim/countries uç nokta — rastgele dizgiler artık kabul edilmiyor.
| Parametre | Kabul edilen değer | Kaynak |
|---|---|---|
| ülke | Tam ülke adı | Ülke API'sinden gelen ad alanı |
| ülkeKodu | ISO ülke kodu | Ülke API'sinden gelen kod alanı |
Gerekli eylem: Eğer şu anda serbest metin ülke dizgileri kullanıyorsanız, entegrasyonunuzu güncelleyerek önce GET /api/esim/countries çağrısını yapın ve yanıtın içindeki ad veya kod değerlerini kullanın.
Yeni Uç Noktalar #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Roamify eSIM tarafından desteklenen tüm ülkelerin bir listesini döndürür. name ve code değerlerini, GET /api/esim/packages sorgularken filtre girdileri olarak kullanın.
isteğe bağlı filtre parametresi mevcut coğrafya
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Bir SMS mesajını doğrudan bir eSIM'e gönderin.
| Ad | Tür | Gerekli | Açıklama |
|---|---|---|---|
| iccid | dize | gerekli | SMS göndermek için eSIM'in ICCID'si. |
| mesaj | dize | gerekli | Gönderilecek mesaj içeriği. |
Güncellenmiş Uç Noktalar #
POST /api/esim/apply — başlangıçTarihi artık destekleniyor #
Yeni bir isteğe bağlı startDate alanı Generate eSIM Profile uç noktasına eklendi. Paketlerin küçük bir alt kümesi için (~30 tanesi 28,000+ üzerinde), bu alan gereklidir.
Bu paketleri, requirements.travelDate değerinin true paket nesnesinde. Gerekli ve sağlanmazsa, profil oluşturma isteği başarısız olur.
| Ad | Tür | Gerekli | Açıklama |
|---|---|---|---|
| başlangıçTarihi | string | koşullu | ISO 8601 formatında seyahat başlangıç tarihi. requirements.travelDate doğruysa gereklidir. |
Zaman aşımı hatırlatıcısı
Tam API Referansı #
Tam dokümantasyon şu adreste mevcuttur: docs.getroamify.com.
Herhangi bir sorunuz varsa veya entegrasyonunuzu güncellemek için yardıma ihtiyacınız olursa, ortak destek ekibimizle iletişime geçin.
Sık sorulan sorular
- Roamify eSIM API Kırılma Değişiklikleri'de ne öğreneceğim?
- eSIM etkinleştirmenin nasıl çalıştığını, veri planlarını nasıl karşılaştıracağınızı ve seyahatiniz öncesinde ve sırasında hangi kurulum adımlarının en önemli olduğunu öğreneceksiniz.
- Japonya için doğru eSIM planını nasıl seçerim?
- Planınızı seyahat uzunluğuna, beklenen günlük veri kullanımına, erişim noktası ihtiyaçlarına ve varış noktanızdaki ağ kalitesine göre eşleştirin. Kısa süreli konaklamalar genellikle daha az veriye ihtiyaç duyarken, uzaktan çalışma ve görüntülü görüşmeler daha fazla veriye ihtiyaç duyar.
- Japonya ve Tayland için seyahat eSIM planlarını nereden satın alabilirim?
- Doğrudan Roamify ülke sayfalarına gitmek, plan seçeneklerini karşılaştırmak ve ayrılmadan önce ödeme işlemini tamamlamak için bu kılavuzdaki varış yeri bağlantılarını kullanın.