Roamify eSIM API Modifiche Importanti
Donald Bogle
June 9, 2026 22:20
Stiamo implementando un insieme di aggiornamenti API che portano nuovi endpoint, funzionalità ampliate e alcune modifiche di cui dovrai essere a conoscenza prima di aggiornare la tua integrazione.
⚠️ Modifiche importanti — Ottieni pacchetti eSIM #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. La risposta è ora paginata #
Questo endpoint ora restituisce risultati paginati invece di tutti i pacchetti in un'unica risposta. Se la tua integrazione recupera pacchetti senza parametri di paginazione, potresti ricevere solo la prima pagina di risultati.
Azione richiesta: Aggiorna la tua integrazione per gestire le risposte paginate utilizzando i parametri di query page e pageSize.
| Parametro | Tipo | Predefinito | Descrizione |
|---|---|---|---|
| pagina | stringa | 1 | Numero di pagina da recuperare. |
| dimensionePagina | stringa | 50 | Numero di risultati per pagina. |
Per recuperare tutti i pacchetti, itera attraverso le pagine fino a quando la risposta restituisce meno risultati di quanto il tuo dimensionePagina.
2. paese e codicePaese ora hanno significati distinti #
In precedenza, questi campi potevano essere stati usati in modo intercambiabile. Ora servono a scopi diversi e entrambi devono utilizzare valori provenienti da GET /api/esim/countries endpoint — le stringhe arbitrarie non sono più accettate.
| Parameter | Valore accettato | Source |
|---|---|---|
| paese | Nome completo del paese | campo name dall'API Country |
| countryCode | codice paese ISO | campo code dall'API Country |
Azione richiesta: Se attualmente stai passando stringhe di paese in testo libero, aggiorna la tua integrazione per prima chiamare GET /api/esim/countries e utilizzare i valori name o code dalla risposta.
Nuovi Endpoint #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Restituisce un elenco di tutti i paesi supportati da Roamify eSIM. Usa i valori name e code di questa risposta come input di filtro quando interroghi GET /api/esim/packages.
parametro di filtro opzionale disponibile con geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Invia un messaggio SMS direttamente a un'eSIM.
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| iccid | string | obbligatorio | L'ICCID dell'eSIM a cui inviare l'SMS. |
| messaggio | string | obbligatorio | Il contenuto del messaggio da inviare. |
Endpoint aggiornati #
POST /api/esim/apply — startDate ora supportato #
Un nuovo campo opzionale startDate è stato aggiunto all'endpoint Genera profilo eSIM. Per un piccolo sottoinsieme di pacchetti (~30 su oltre 28.000), questo campo è obbligatorio.
Puoi identificare questi pacchetti controllando se requirements.travelDate è true nell'oggetto pacchetto. Se richiesto e non fornito, la richiesta di generazione del profilo fallirà.
| Nome | Tipo | Richiesto | Descrizione |
|---|---|---|---|
| dataInizio | stringa | condizionale | Data di inizio viaggio nel formato ISO 8601. Richiesta se requirements.travelDate è vero. |
Promemoria timeout
Riferimento API completo #
La documentazione completa è disponibile su docs.getroamify.com.
Se hai domande o hai bisogno di aiuto per aggiornare la tua integrazione, contatta il nostro team di supporto partner.
Piani di destinazione eSIM correlati
Domande frequenti
- Cosa imparerò in Roamify eSIM API Modifiche Importanti?
- Imparerai come funziona l'attivazione dell'eSIM, come confrontare i piani dati e quali passaggi di configurazione sono più importanti prima e durante il viaggio.
- Come faccio a scegliere il piano eSIM giusto per Giappone?
- Abbina il tuo piano alla durata del viaggio, all'utilizzo giornaliero previsto dei dati, alle esigenze dell'hotspot e alla qualità della rete nella tua destinazione. I soggiorni brevi di solito richiedono meno dati, mentre il lavoro a distanza e le videochiamate ne richiedono di più.
- Dove posso acquistare piani eSIM di viaggio per Giappone e Thailandia?
- Utilizza i collegamenti di destinazione in questa guida per accedere direttamente alle pagine dei paesi Roamify, confrontare le opzioni dei piani e completare il pagamento prima della partenza.