Roamify eSIM API Changements Importants
Donald Bogle
June 9, 2026 22:20
Nous déployons un ensemble de mises à jour de l'API qui apportent de nouveaux points de terminaison, une fonctionnalité étendue et quelques changements dont vous voudrez être conscient avant de mettre à jour votre intégration.
⚠️ Changements majeurs — Obtenez des forfaits eSIM #
Point de terminaison : GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. La réponse est maintenant paginée #
Ce point de terminaison renvoie maintenant des résultats paginés au lieu de tous les forfaits dans une seule réponse. Si votre intégration récupère des forfaits sans paramètres de pagination, vous ne recevez peut-être que la première page des résultats.
Action requise : Mettez à jour votre intégration pour gérer les réponses paginées en utilisant les paramètres de requête page et pageSize.
| Paramètre | Type | Par défaut | Description |
|---|---|---|---|
| page | chaîne | 1 | Numéro de page à récupérer. |
| pageSize | chaîne | 50 | Nombre de résultats par page. |
Pour récupérer tous les forfaits, parcourez les pages jusqu'à ce que la réponse renvoie moins de résultats que votre pageSize.
2. pays et codePays ont maintenant des significations distinctes #
Auparavant, ces champs pouvaient avoir été utilisés de manière interchangeable. Ils servent maintenant des objectifs différents et les deux doivent utiliser des valeurs provenant de la GET /api/esim/countries point de terminaison — les chaînes arbitraires ne sont plus acceptées.
| Paramètre | Valeur acceptée | Source |
|---|---|---|
| pays | Nom complet du pays | champ name de l'API Country |
| countryCode | code de pays ISO | champ code de l'API Country |
Action requise : Si vous passez actuellement des chaînes de pays en texte libre, mettez à jour votre intégration pour d'abord appeler GET /api/esim/countries et utilisez les valeurs name ou code de la réponse.
Nouveaux points de terminaison #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Renvoie une liste de tous les pays pris en charge par Roamify eSIM. Utilisez les valeurs name et code de cette réponse comme entrées de filtre lors de la requête GET /api/esim/packages.
paramètre de filtre optionnel disponible avec geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Envoyer un message SMS directement à un eSIM.
| Nom | Type | Requis | Description |
|---|---|---|---|
| iccid | chaîne | requis | L'ICCID de l'eSIM à laquelle envoyer le SMS. |
| message | chaîne | requis | Le contenu du message à envoyer. |
Points de terminaison mis à jour #
POST /api/esim/apply — dateDeDébut maintenant pris en charge #
Un nouveau champ optionnel dateDeDébut a été ajouté au point de terminaison Générer le profil eSIM. Pour un petit sous-ensemble de forfaits (~30 sur 28 000+), ce champ est requis.
Vous pouvez identifier ces forfaits en vérifiant si requirements.travelDate est vrai dans l'objet du package. Si requis et non fourni, la demande de génération de profil échouera.
| Nom | Type | Requis | Description |
|---|---|---|---|
| dateDébut | chaîne | conditionnel | Date de début de voyage au format ISO 8601. Requis si requirements.travelDate est vrai. |
Rappel de délai d'attente
Référence API complète #
La documentation complète est disponible sur docs.getroamify.com.
Si vous avez des questions ou avez besoin d'aide pour mettre à jour votre intégration, contactez notre équipe de support partenaire.
Forfaits de destination eSIM associés
Questions fréquemment posées
- Que vais-je apprendre dans Roamify eSIM API Changements Importants ?
- Vous apprendrez comment fonctionne l'activation eSIM, comment comparer les forfaits de données et quelles étapes de configuration sont les plus importantes avant et pendant votre voyage.
- Comment choisir le bon forfait eSIM pour Japon ?
- Adaptez votre plan à la durée du voyage, à l'utilisation quotidienne prévue des données, aux besoins en points d'accès et à la qualité du réseau dans votre destination. Les courts séjours nécessitent généralement moins de données, tandis que le travail à distance et les appels vidéo en nécessitent davantage.
- Où puis-je acheter des forfaits eSIM de voyage pour Japon et Thaïlande ?
- Utilisez les liens de destination de ce guide pour accéder directement aux pages des pays Roamify, comparer les options de forfait et finaliser le paiement avant le départ.