9 min di letturaMigrazione

Migrazione da Short.io: export, import e checklist di cutover

Pianifica una migrazione da Short.io: opzioni di export, cosa si porta dietro, mappatura di domini, cartelle e tag, l'importer di Elido, cutover DNS e verifica.

Marius Voß
DevRel · edge infra
Diagramma della pipeline: l'API REST di Short.io a sinistra confluisce attraverso il worker di import di Elido nella tabella dei link, con un pannello laterale che elenca le garanzie numeriche del worker (limite di 50k, budget di 30 minuti, 150 per pagina, token solo in memoria)

Una migrazione da Short.io ha quattro parti: portare fuori i tuoi link, decidere come domini, cartelle e tag arrivano nel nuovo strumento, spostare il DNS e dimostrare che nulla si è rotto. Elido può prelevare i link direttamente dall'API di Short.io, quindi non serve alcun CSV, ma l'importer ha dei limiti che devi conoscere prima di iniziare. Questa guida copre le opzioni di export documentate da Short.io, cosa l'importer di Elido porta con sé e cosa scarta, un ordine di cutover che evita i downtime e una checklist di verifica.

I fatti su Short.io qui sotto vengono dalla documentazione di Short.io stessa, consultata il 2026-10-02. Il comportamento di Elido è stato controllato sul codice sorgente dell'importer e sulla dashboard, non su una pagina di marketing.

Le opzioni di export di Short.io in sintesi

Hai tre modi per estrarre l'elenco dei link da Short.io. Quale scegli decide cosa sopravvive.

MetodoCosa ottieniInsidia
Export CSV (per dominio o link selezionati)ID, URL breve, path, URL originale, titolo, clic, creazione, aggiornamento, scadenza, creato da, tagNon abilitato di default; chiedi al supporto di Short.io di attivarlo. L'export in blocco arriva via email
Endpoint di elenco dell'API RESTTutto quanto sopra più cartella, password, cloaking, tipo di redirect, campi UTM, URL per dispositivoRichiede una chiave API segreta e la paginazione. Restituisce fino a 150 link per chiamata
Importer di ElidoDestinazione, slug, titolo, tag (tramite la chiave API che incolli)Per dominio, e non legge i campi extra della riga dell'API

L'endpoint di elenco è la fonte più ricca. Filtra per dominio, cartella e intervallo di date, ordina per data di creazione e restituisce un nextPageToken per la paginazione. Ne fa lo strumento giusto per un audit delle cose che l'importer non porterà, la parte che la maggior parte delle guide salta.

Short.io ha anche un importer CSV per la direzione opposta, con colonne per URL, slug, tag, titolo e data di creazione (guida all'import). Se preferisci uno script, Elido ha un endpoint API per la creazione di link in blocco e le colonne CSV sopra corrispondono a destinazione, slug, titolo e tag.

Passo 1: fai un audit prima di spostare qualsiasi cosa

Esegui prima un audit del dominio di origine. Non salterei questo passaggio: costa poco ed è l'unico modo per scoprire quali link richiedono lavoro manuale prima che lo scoprano i visitatori.

  1. Esporta il CSV o scorri l'API e conta i link per dominio. Confrontali con il limite di 50.000 per esecuzione.
  2. Filtra i link con un expiresAt, una password, cloaking: true, URL per dispositivo (androidURL, iphoneURL) o un URL diviso. Sono i link che l'importer ricreerà come semplici redirect.
  3. Annota il tipo di redirect. Short.io ti lascia scegliere 301, 302, 307 o 308 per link. L'importer non lo legge, quindi decidi cosa vuoi su Elido. I compromessi sono in redirect 301 e 302.
  4. Archivia la colonna dei clic. Conserva il CSV; è l'unica traccia dei totali per link una volta disdetto.

Domini e cartelle: come funziona la mappatura

Short.io organizza tutto sotto un dominio. Elido organizza sotto un workspace e un workspace possiede i domini.

  • Dominio personalizzato tuo: aggiungilo al workspace e cambia tu il DNS. L'importer non lo fa.
  • Sottodominio di Short.io: i link si importano su un nuovo dominio Elido, ma i vecchi URL su quel sottodominio smettono di risolversi.
  • Cartella: ricostruiscila come cartella nell'elenco dei link dopo l'import. Non portata dall'importer.
  • Tag: portato, più un tag imported:shortio.
  • Path (slug): portato, senza lo / iniziale.

Qui contano due dettagli. Primo, l'importer porta un dominio Short.io in un dominio Elido per job. Se gestisci tre domini, avvii tre job, uno dopo l'altro. Secondo, l'importer non imposta nessuna cartella. Lo schema pratico è filtrare l'elenco dei link di Elido per un tag di Short.io, selezionare i link e spostarli in una cartella. Se le cartelle erano il tuo strumento principale di organizzazione in Short.io, convertisci ognuna in un tag in Short.io prima dell'import così il tag viaggia con il link.

Elenco dei link di Elido con colonne di link breve, destinazione, clic, tag e cartella e una barra con All links, Unfiled e New folder sopra la tabella

L'elenco dei link di Elido in un workspace DEMO con dati di esempio (tutti i numeri sono sintetici). Tag e colonna delle cartelle sono dove finiscono i metadati importati da Short.io.

Eseguire l'importer di Elido

L'importer si trova nella dashboard in Integrations, poi Short.io. La pagina dell'integrazione e la landing migrare da Short.io descrivono lo stesso flusso.

  1. In Short.io, crea una chiave API segreta sotto Integrations e API. L'importer legge soltanto.
  2. In Elido, apri la scheda di migrazione di Short.io e incolla la chiave. La scheda dichiara che la chiave non viene mai salvata: resta in memoria per l'esecuzione e viene scartata quando il job finisce.
  3. Digita l'hostname del dominio Short.io da cui importare, ad esempio example.short.gy.
  4. Scegli il dominio Elido di destinazione, che deve essere già stato aggiunto al tuo workspace.
  5. Scegli una strategia sui conflitti e avvia. Il job interroga il proprio avanzamento ogni due secondi nella dashboard.

Le tre strategie sui conflitti si comportano così. Suffix rinomina uno slug in collisione in name-2, name-3 e così via. Skip lascia stare il link Elido esistente e registra la riga sorgente nel log. Fail ferma l'intero job alla prima collisione. Suffix è il default sicuro per una prima esecuzione su un dominio vuoto; usa skip quando riesegui dopo un import parziale.

Sotto il cofano il worker richiede 150 link per pagina e segue il nextPageToken di Short.io finché non finisce. Un'esecuzione è limitata a 50.000 link e 30 minuti, l'avanzamento viene riscritto ogni 50 link e il log degli errori conserva le prime 1.000 righe problematiche. Un link senza URL di destinazione o con slug vuoto viene registrato come fallimento e l'esecuzione continua. I titoli sono tagliati a 200 caratteri.

Controlla il primo risultato prima di fidarti del secondo dominio. Apri una manciata di link importati, confronta slug e destinazione con il CSV di Short.io e solo allora metti in coda il job successivo.

Cosa non viene portato

Sii esplicito su questa lista nel tuo piano di progetto. L'importer legge solo i campi della prima tabella sopra.

  • Password, date di scadenza, cloaking, URL per dispositivo e split test. Arrivano come semplici redirect. Ricostruisci l'instradamento per geografia e dispositivo come regole degli smart link. Anche i link di Elido hanno i propri campi di scadenza e password, quindi impostali a partire dalla tua lista dell'audit.
  • Cartelle. Ricostruisci a mano, vedi sopra.
  • Tipo di redirect. Impostalo di nuovo se ti affidi al comportamento 301 contro 302.
  • Stato archiviato. L'importer non lo controlla. Verifica i link archiviati nel tuo CSV rispetto a ciò che compare in Elido.
  • Pixel e webhook. Sono configurati separatamente dai link in Short.io. Ricreali nel workspace di Elido e riemetti i secret dei webhook, dato che le firme differiscono tra i due prodotti.
  • Cronologia dei clic. Vedi la sezione successiva.

Cosa succede alla cronologia degli analytics

La cronologia dei singoli clic non si sposta. L'importer crea link e nient'altro, quindi Elido comincia a contare dal primo clic che serve. Vale per ogni importer della dashboard di Elido e per la maggior parte degli strumenti della categoria.

Hai due opzioni oneste. Tieni il CSV di Short.io, che porta un totale di clic per link, e archivialo con la data del cutover come tua baseline. Oppure, se hai un piano Enterprise, chiedi a Short.io l'export delle statistiche su S3, che Short.io offre su richiesta. Dopo il cutover, la vista analytics mostra clic al giorno, paesi, referrer e host per l'intero workspace.

Panoramica analytics di Elido con un grafico dei clic al giorno e pannelli dei paesi principali, dei referrer principali e degli host principali

La panoramica analytics di Elido in un workspace DEMO con dati di esempio (numeri sintetici, non risultati di clienti). Dopo il cutover questa vista contiene solo i clic serviti da Elido.

Cutover: un ordine sicuro per i domini personalizzati

I link su un hostname che possiedi possono spostarsi senza che nessuno se ne accorga, se segui l'ordine. I link su un sottodominio di Short.io no, perché non controlli quel nome DNS.

  1. Aggiungi prima l'hostname a Elido. Aggiungilo sotto i domini personalizzati, pubblica il record TXT di verifica e aspetta la verifica. La meccanica è in TLS per un dominio personalizzato in 5 minuti e nella pagina della funzione domini personalizzati.
  2. Importa su quell'hostname mentre Short.io serve ancora il traffico di produzione. Per i visitatori non cambia ancora nulla.
  3. Verifica i link su Elido provando gli slug sul nuovo edge prima che il DNS cambi (vedi la checklist sotto).
  4. Abbassa il TTL del record esistente un giorno prima, così il passaggio si propaga in fretta.
  5. Cambia il record. La guida di Short.io usa un record A sulla radice (207.174.61.1 al momento della consultazione). Elido usa un CNAME verso edge.elido.me. Un CNAME non può stare sull'apex nudo (RFC 1034), quindi per un hostname apex ti serve ALIAS o CNAME flattening presso il tuo provider DNS, oppure passi a un sottodominio.
  6. Tieni attivo Short.io per un ciclo di fatturazione come rollback. Se qualcosa non torna, ripristina il record.

Se ti interessa anche il traffico di ricerca e di referral, controlla che i tuoi vecchi URL brevi si risolvano in un solo salto. Le catene fanno perdere tempo e sono trattate in catene di redirect e SEO.

Checklist di verifica

Eseguila dopo la propagazione del DNS, su un campione di almeno 50 link o su tutti i link se ne hai meno.

  • Il conteggio importato corrisponde al conteggio di origine, una volta contabilizzate le righe saltate e fallite dal log degli errori del job.
  • Dieci slug casuali restituiscono la stessa destinazione del CSV di Short.io.
  • I link che hai segnalato nell'audit (scadenza, password, regole per dispositivo) sono stati ricreati e provati.
  • dig CNAME go.example.com +short restituisce l'edge di Elido e HTTPS si carica senza avvisi sul certificato.
  • I QR code e il materiale stampato che usano il vecchio dominio si risolvono ancora.
  • Un clic di prova compare negli analytics di Elido.
  • Il CSV di Short.io con i totali dei clic è archiviato da qualche parte di durevole.
  • Webhook, pixel e base URL degli SDK ora puntano a Elido.

Non ogni account dovrebbe spostarsi. Se usi solo un sottodominio di Short.io, una migrazione cambia ogni URL pubblico e il lavoro è più grande di quanto suggerisca l'importer. Gli articoli di confronto ti aiutano a decidere: Elido vs Short.io, l'elenco più ampio delle alternative a Short.io e i confronti diretti Short.io vs Bitly e Short.io vs Rebrandly. Se stai valutando un altro strumento di origine, il playbook per TinyURL segue la stessa struttura.

Pronto a provarlo prima su un piccolo dominio? Avvia l'import da Short.io con un dominio di test, controlla i risultati rispetto al tuo CSV e decidi sul resto da lì.

Correlati sul blog

Domande frequenti

Come esporto i miei link da Short.io?

Short.io documenta due export CSV: seleziona i link nel menu Branded links e clicca Export, oppure apri le impostazioni del dominio e scegli Export links per ricevere un file via email. Short.io dice che la funzione non è abilitata di default, quindi devi prima contattare il loro supporto. L'alternativa è l'API, che non richiede approvazione.

Posso tenere il mio dominio personalizzato quando lascio Short.io?

Sì, se possiedi l'hostname. Aggiungilo a Elido, importa i link su di esso, poi cambia il record DNS presso il tuo registrar. I vecchi URL brevi continuano a funzionare perché l'hostname ora punta a Elido. I sottodomini di Short.io come example.short.gy restano con Short.io.

Elido importa le cartelle di Short.io?

Non come cartelle. L'importer legge destinazione, slug, titolo e tag di ogni link e aggiunge un tag imported:shortio. L'assegnazione alle cartelle non fa parte di quel payload, quindi ricostruisci le cartelle nell'elenco dei link di Elido e usa i tag per trovare cosa appartiene a cosa.

Posso spostare la cronologia dei clic di Short.io?

No. L'importer crea link, non eventi di clic. L'export CSV di Short.io include una colonna clicks con un totale per link, che vale la pena archiviare, e Short.io offre su richiesta un export delle statistiche su S3 nei piani Enterprise. I nuovi clic in Elido contano dal cutover.

Quanto dura un import da Short.io?

L'importer legge 150 link per richiesta e si ferma a 50.000 link o 30 minuti per esecuzione. Qualche migliaio di link di solito finisce in pochi minuti, a seconda della velocità con cui risponde Short.io. I domini più grandi vanno divisi.

I link di Short.io protetti da password o con scadenza migrano?

L'importer non legge password, date di scadenza, cloaking né target per dispositivo. Prima del cutover compila dall'API di Short.io un elenco di quei link e ricrea il comportamento in Elido, ad esempio con le regole degli smart link e la scadenza dei link.

Prova Elido

Incolla un URL, ottieni un link breve

Senza registrazione. Il link vive 30 giorni. Iscriviti per conservarlo.

Gratis, nessuna registrazione richiesta · 2 al giorno

Prova Elido

Accorciatore di URL ospitato nell'UE: domini personalizzati, analisi approfondite e API aperta. Piano gratuito - senza carta di credito.

Tag
short.io migration
migrate from short.io
short.io export links
short.io custom domain migration
short.io to elido
short.io csv export

Continua a leggere