Roamify eSIM API Modifiche Importanti
Scopri gli ultimi aggiornamenti dell'API eSIM di Roamify, inclusi nuovi riscontri paginati per GET /api/esim/packages, validazione più rigorosa dei paesi e…
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.
Domande frequenti
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.
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ù.
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.
Piani eSIM popolari
Destinazioni selezionate per il tuo prossimo viaggio.
Acquista piani eSIM per Turchia
Acquista piani eSIM per Thailandia
Acquista piani eSIM per Emirati Arabi Uniti
Acquista piani eSIM per Singapore
Acquista piani eSIM per Australia
Acquista piani eSIM per MessicoIn partenza per una nuova meta? Resta connesso non appena atterri.
Dati di viaggio convenienti per oltre 200 destinazioni. Niente costi di roaming, niente spese nascoste, basta scansionare e partire.
Continua a leggere
Tutti gli articoli
eSIM per il Perù: La guida completa alla connettività per il 2026
Stai pianificando un viaggio in Perù nel 2026? Rimani connesso tra Lima, Cusco, Machu Picchu, la Valle Sacra e l'Amazzonia con una eSIM senza problemi. Scopri come controllare la compatibilità del dispositivo, scegliere il piano dati giusto, comprendere la copertura per regione e decidere tra una eSIM e una SIM locale. Scopri perché le eSIM economiche solo dati di Roamify (a partire da $2) sono ideali per i viaggiatori che desiderano attivazione istantanea all'arrivo, senza costi di roaming e dati mobili affidabili in tutto il Perù.
Marissa Ling 
eSIM per l'Arabia Saudita: Come rimanere connessi come visitatore nel 2026
Stai pianificando un viaggio in Arabia Saudita nel 2026? Salta il costoso roaming e le code per le SIM in aeroporto utilizzando una eSIM da viaggio. Questa guida spiega la compatibilità delle eSIM, la copertura su STC, Mobily e Zain, la disponibilità di 4G/5G a Riyadh, Jeddah, Mecca, Medina e AlUla, quanto dati hai realmente bisogno e la procedura passo-passo per configurare l'eSIM prima di volare. Confronta i principali fornitori come Roamify, Airalo e Holafly, scopri l'uso di VPN e app (WhatsApp, Telegram, social media) e ottieni consigli pratici per rimanere connesso senza problemi durante il Hajj, l'Umrah, viaggi di lavoro o di piacere in Arabia Saudita.
Michael Harbour
Roamify Partner Program: How to Earn Money Reselling eSIMs in 2026
Discover the Roamify Partner Program, a high-converting travel eSIM affiliate and reseller opportunity built for bloggers, comparison sites, travel agencies, and digital nomad communities. Promote data-only eSIMs from just $2 with coverage in 200+ countries, a 4.6 Trustpilot rating, top-ranked customer support, and a 5% discount code (ROAM5) to boost conversions. Apply in minutes at partner.getroamify.com and start earning commissions by recommending one of the cheapest, most reliable travel eSIM providers on the market.
Donald Bogle