Roamify eSIM API Änderungen mit Auswirkungen
Donald Bogle
June 9, 2026 22:20
Wir führen eine Reihe von API-Updates ein, die neue Endpunkte, erweiterte Funktionen und einige Änderungen bringen, über die Sie sich vor der Aktualisierung Ihrer Integration im Klaren sein sollten.
⚠️ Breaking Changes — eSIM-Pakete erhalten #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Die Antwort ist jetzt paginiert #
Dieser Endpunkt gibt jetzt paginierte Ergebnisse zurück, anstatt alle Pakete in einer einzigen Antwort. Wenn Ihre Integration Pakete ohne Paginierungsparameter abruft, erhalten Sie möglicherweise nur die erste Seite der Ergebnisse.
Aktion erforderlich: Aktualisieren Sie Ihre Integration, um paginierte Antworten mit den page und pageSize Abfrageparametern zu verarbeiten.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| Seite | Zeichenfolge | 1 | Seitennummer zum Abrufen. |
| seitenGröße | Zeichenfolge | 50 | Anzahl der Ergebnisse pro Seite. |
Um alle Pakete abzurufen, iterieren Sie durch die Seiten, bis die Antwort weniger Ergebnisse zurückgibt als Ihre seitenGröße.
2. Land und countryCode haben jetzt unterschiedliche Bedeutungen #
Früher konnten diese Felder austauschbar verwendet werden. Sie dienen jetzt unterschiedlichen Zwecken und beide müssen Werte verwenden, die von der GET /api/esim/countries Schnittstelle stammen — willkürliche Zeichenfolgen werden nicht mehr akzeptiert.
| Parameter | Akzeptierter Wert | Quelle |
|---|---|---|
| Land | Vollständiger Ländername | name-Feld aus der Country API |
| countryCode | ISO-Ländercode | Code-Feld aus der Länder-API |
Aktion erforderlich: Wenn Sie derzeit Freitext-Länderstrings übergeben, aktualisieren Sie Ihre Integration, um zuerst GET /api/esim/countries aufzurufen und die name oder code Werte aus der Antwort zu verwenden.
Neue Endpunkte #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Gibt eine Liste aller von Roamify eSIM unterstützten Länder zurück. Verwenden Sie die name und code Werte aus dieser Antwort als Filtereingaben bei der Abfrage verwenden GET /api/esim/packages.
optionaler Filterparameter verfügbar mit geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Senden Sie eine SMS-Nachricht direkt an eine eSIM.
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| iccid | string | erforderlich | Die ICCID der eSIM, an die die SMS gesendet werden soll. |
| Nachricht | string | erforderlich | Der Inhalt der zu sendenden Nachricht. |
Aktualisierte Endpunkte #
POST /api/esim/apply — startDate jetzt unterstützt #
Ein neues optionales startDate Feld wurde zum Generieren des eSIM-Profils hinzugefügt. Für eine kleine Anzahl von Paketen (~30 von über 28.000) ist dieses Feld erforderlich.
Sie können diese Pakete identifizieren, indem Sie überprüfen, ob requirements.travelDate gleich true im Paketobjekt ist. Wenn erforderlich und nicht bereitgestellt, schlägt die Anfrage zur Profilerstellung fehl.
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| startDate | string | bedingt | Reisebeginn im ISO 8601-Format. Erforderlich, wenn requirements.travelDate wahr ist. |
Timeout-Erinnerung
Vollständige API-Referenz #
Die vollständige Dokumentation ist verfügbar unter docs.getroamify.com.
Wenn Sie Fragen haben oder Hilfe bei der Aktualisierung Ihrer Integration benötigen, wenden Sie sich an unser Partner-Support-Team.
Verwandte eSIM-Zielpläne
Häufig gestellte Fragen
- Was werde ich in Roamify eSIM API Änderungen mit Auswirkungen lernen?
- Sie erfahren, wie die eSIM-Aktivierung funktioniert, wie Sie Datentarife vergleichen und welche Einrichtungsschritte vor und während Ihrer Reise am wichtigsten sind.
- Wie wähle ich den richtigen eSIM-Plan für Japan aus?
- Passen Sie Ihren Plan an die Reisedauer, die erwartete tägliche Datennutzung, die Hotspot-Anforderungen und die Netzwerkqualität an Ihrem Zielort an. Bei kurzen Aufenthalten sind in der Regel weniger Daten erforderlich, bei Remote-Arbeiten und Videoanrufen dagegen mehr.
- Wo kann ich Reise-eSIM-Pläne für Japan und Thailand kaufen?
- Verwenden Sie die Ziellinks in diesem Leitfaden, um direkt zu den Roamify-Länderseiten zu gelangen, Tarifoptionen zu vergleichen und den Checkout vor der Abreise abzuschließen.