9 min de lectureMigration

Migration Short.io : export, import, liste de bascule

Planifiez une migration Short.io : options d'export, ce qui suit, mappage des domaines, dossiers et tags, importeur Elido, bascule DNS et vérification.

Marius Voß
DevRel · edge infra
Schéma de pipeline : l'API REST de Short.io à gauche traverse le worker d'import Elido vers la table des liens, avec un panneau latéral listant les garanties chiffrées du worker (plafond de 50k, budget de 30 min, 150 par page, jeton en mémoire uniquement)

Une migration Short.io comporte quatre parties : sortir vos liens, décider comment les domaines, dossiers et tags atterrissent dans le nouvel outil, déplacer le DNS, et prouver que rien n'a cassé. Elido peut récupérer les liens directement depuis l'API Short.io, donc aucun CSV n'est nécessaire, mais l'importeur a des limites à connaître avant de commencer. Ce guide couvre les options d'export que Short.io documente, ce que l'importeur Elido reprend et abandonne, un ordre de bascule qui évite l'indisponibilité, et une liste de vérification.

Les faits sur Short.io ci-dessous proviennent de la documentation de Short.io elle-même, consultée le 2026-10-02. Le comportement d'Elido a été vérifié dans le code source de l'importeur et le tableau de bord, pas sur une page marketing.

Les options d'export Short.io en un coup d'œil

Vous avez trois façons de sortir votre liste de liens de Short.io. Celle que vous choisissez décide de ce qui survit.

MéthodeCe que vous obtenezPiège
Export CSV (par domaine ou liens sélectionnés)ID, URL courte, chemin, URL d'origine, titre, clics, création, mise à jour, expiration, créé par, tagsNon activé par défaut ; vous demandez au support Short.io de l'activer. L'export en masse arrive par e-mail
Endpoint de liste de l'API RESTTout ce qui précède plus dossier, mot de passe, cloaking, type de redirection, champs UTM, URL par appareilExige une clé d'API secrète et de la pagination. Renvoie jusqu'à 150 liens par appel
Importeur ElidoDestination, slug, titre, tags (via la clé d'API que vous collez)Par domaine, et il ne lit pas les champs supplémentaires de la ligne API

L'endpoint de liste est la source la plus riche. Il filtre par domaine, dossier et plage de dates, trie par date de création, et renvoie un nextPageToken pour la pagination. C'est donc le bon outil pour auditer ce que l'importeur ne reprendra pas, la partie que la plupart des guides sautent.

Short.io dispose aussi d'un importeur CSV pour le sens inverse, avec des colonnes pour l'URL, le slug, les tags, le titre et la date de création (guide d'import). Si vous préférez scripter, Elido a un endpoint d'API de création de liens en masse, et les colonnes CSV ci-dessus correspondent à destination, slug, titre et tags.

Étape 1 : auditer avant de déplacer quoi que ce soit

Faites d'abord un audit du domaine source. Je ne sauterais pas cette étape : elle coûte peu, et c'est le seul moyen de savoir quels liens demandent un travail manuel avant que les visiteurs ne le découvrent.

  1. Exportez le CSV ou parcourez l'API et comptez les liens par domaine. Comparez avec la limite de 50 000 par exécution.
  2. Filtrez les liens avec un expiresAt, un password, cloaking: true, des URL par appareil (androidURL, iphoneURL) ou une URL scindée. Ce sont les liens que l'importeur recréera comme de simples redirections.
  3. Notez le type de redirection. Short.io vous laisse choisir 301, 302, 307 ou 308 par lien. L'importeur ne le lit pas, donc décidez ce que vous voulez sur Elido. Les compromis sont dans redirections 301 vs 302.
  4. Archivez la colonne des clics. Gardez le CSV ; c'est la seule trace des totaux par lien une fois que vous aurez résilié.

Domaines et dossiers : comment fonctionne le mappage

Short.io organise tout sous un domaine. Elido organise sous un espace de travail, et un espace de travail possède les domaines.

  • Domaine personnalisé que vous possédez : ajoutez-le à l'espace de travail et modifiez le DNS vous-même. L'importeur ne le fait pas.
  • Sous-domaine Short.io : les liens s'importent sur un nouveau domaine Elido, mais les anciennes URL de ce sous-domaine cessent de se résoudre.
  • Dossier : à reconstruire comme dossier dans la liste des liens après l'import. Non repris par l'importeur.
  • Tag : repris, plus un tag imported:shortio.
  • Chemin (slug) : repris, avec le / initial retiré.

Deux détails comptent ici. D'abord, l'importeur fait entrer un domaine Short.io dans un domaine Elido par job. Si vous avez trois domaines, vous lancez trois jobs, l'un après l'autre. Ensuite, l'importeur ne définit aucun dossier. Le schéma pratique est de filtrer la liste des liens Elido par un tag Short.io, de sélectionner les liens et de les déplacer dans un dossier. Si vos dossiers étaient votre principal outil d'organisation chez Short.io, convertissez chacun en tag dans Short.io avant l'import pour que le tag voyage avec le lien.

Liste des liens Elido montrant les colonnes lien court, destination, clics, tags et dossier, avec une barre All links, Unfiled et New folder au-dessus du tableau

La liste des liens Elido dans un espace de travail DEMO avec des données d'exemple (tous les chiffres sont synthétiques). Les tags et la colonne dossier sont l'endroit où atterrissent les métadonnées Short.io importées.

Lancer l'importeur Elido

L'importeur se trouve dans le tableau de bord sous Integrations, puis Short.io. La page d'intégration et la page d'atterrissage migrer depuis Short.io décrivent le même flux.

  1. Dans Short.io, créez une clé d'API secrète sous Integrations et API. L'importeur ne fait que lire.
  2. Dans Elido, ouvrez la carte de migration Short.io et collez la clé. La carte indique que la clé n'est jamais stockée : elle reste en mémoire pendant l'exécution et est abandonnée à la fin du job.
  3. Saisissez le nom d'hôte du domaine Short.io à importer, par exemple example.short.gy.
  4. Choisissez le domaine Elido cible, qui doit déjà être ajouté à votre espace de travail.
  5. Choisissez une stratégie de conflit et lancez. Le job interroge sa propre progression toutes les deux secondes dans le tableau de bord.

Les trois stratégies de conflit se comportent ainsi. Suffix renomme un slug en collision en name-2, name-3 et ainsi de suite. Skip laisse le lien Elido existant tranquille et consigne la ligne source. Fail arrête tout le job à la première collision. Suffix est le choix par défaut sûr pour une première exécution dans un domaine vide ; utilisez skip pour relancer après un import partiel.

En coulisses, le worker demande 150 liens par page et suit le nextPageToken de Short.io jusqu'à épuisement. Une exécution est plafonnée à 50 000 liens et 30 minutes, la progression est réécrite tous les 50 liens, et le journal d'erreurs conserve les 1 000 premières lignes problématiques. Un lien sans URL de destination ou avec un slug vide est consigné comme un échec et l'exécution continue. Les titres sont coupés à 200 caractères.

Vérifiez le premier résultat avant de faire confiance au second domaine. Ouvrez une poignée de liens importés, comparez le slug et la destination avec le CSV Short.io, et seulement ensuite mettez le job suivant en file.

Ce qui ne suit pas

Soyez explicite sur cette liste dans votre plan de projet. L'importeur ne lit que les champs du premier tableau ci-dessus.

  • Mots de passe, dates d'expiration, cloaking, URL par appareil et tests A/B. Ils arrivent comme de simples redirections. Reconstruisez le routage par zone géographique et par appareil avec des règles de liens intelligents. Les liens Elido ont aussi leurs propres champs d'expiration et de mot de passe, donc renseignez-les à partir de votre liste d'audit.
  • Dossiers. À reconstruire à la main, voir plus haut.
  • Type de redirection. Redéfinissez-le si vous vous appuyez sur le comportement 301 ou 302.
  • État archivé. L'importeur ne le vérifie pas. Vérifiez les liens archivés de votre CSV par rapport à ce qui apparaît dans Elido.
  • Pixels et webhooks. Ils sont configurés séparément des liens dans Short.io. Recréez-les dans l'espace de travail Elido et réémettez les secrets de webhooks, car les signatures diffèrent entre les deux produits.
  • Historique de clics. Voir la section suivante.

Ce qu'il advient de l'historique d'analyses

L'historique par clic ne migre pas. L'importeur crée des liens et rien d'autre, donc Elido commence à compter à partir du premier clic qu'il sert. C'est vrai de tous les importeurs du tableau de bord Elido et de la plupart des outils de la catégorie.

Vous avez deux options honnêtes. Gardez le CSV Short.io, qui contient un total de clics par lien, et archivez-le avec la date de bascule comme référence. Ou, si vous avez une offre Enterprise, demandez à Short.io l'export de statistiques S3, que Short.io propose sur demande. Après la bascule, la vue d'analyses montre les clics par jour, les pays, les référents et les hôtes pour tout l'espace de travail.

Vue d'ensemble des analyses Elido avec un graphique des clics par jour et des panneaux principaux pays, principaux référents et principaux hôtes

La vue d'ensemble des analyses Elido dans un espace de travail DEMO avec des données d'exemple (chiffres synthétiques, pas des résultats clients). Après la bascule, cette vue ne contient que les clics servis par Elido.

Bascule : un ordre sûr pour les domaines personnalisés

Les liens sur un nom d'hôte que vous possédez peuvent migrer sans que personne ne s'en aperçoive, si vous suivez l'ordre. Les liens sur un sous-domaine Short.io ne le peuvent pas, car vous ne contrôlez pas ce nom DNS.

  1. Ajoutez d'abord le nom d'hôte à Elido. Ajoutez-le sous domaines personnalisés, publiez l'enregistrement TXT de vérification et attendez la vérification. La mécanique est dans TLS pour domaine personnalisé en 5 minutes et la page de la fonctionnalité domaines personnalisés.
  2. Importez sur ce nom d'hôte pendant que Short.io sert encore le trafic de production. Rien ne change encore pour les visiteurs.
  3. Vérifiez les liens sur Elido en testant les slugs contre le nouveau edge avant que le DNS ne change (voir la liste ci-dessous).
  4. Abaissez le TTL de l'enregistrement existant un jour avant, pour que le changement se propage vite.
  5. Changez l'enregistrement. Le guide de Short.io utilise un enregistrement A sur la racine (207.174.61.1 à la consultation). Elido utilise un CNAME vers edge.elido.me. Un CNAME ne peut pas se placer sur l'apex nu (RFC 1034), donc pour un nom d'hôte à l'apex il vous faut ALIAS ou l'aplatissement de CNAME chez votre fournisseur DNS, ou bien passer à un sous-domaine.
  6. Gardez Short.io actif pendant un cycle de facturation comme retour arrière. Si quelque chose semble anormal, rétablissez l'enregistrement.

Si vous tenez aussi au trafic de recherche et de référencement, vérifiez que vos anciennes URL courtes se résolvent en un seul saut. Les chaînes coûtent du temps et sont traitées dans chaînes de redirections et SEO.

Liste de vérification

Lancez-la après la propagation du DNS, sur un échantillon d'au moins 50 liens ou sur tous les liens si vous en avez moins.

  • Le nombre importé correspond au nombre source, une fois comptabilisées les lignes ignorées et en échec du journal d'erreurs du job.
  • Dix slugs aléatoires renvoient la même destination que le CSV Short.io.
  • Les liens que vous avez signalés à l'audit (expiration, mot de passe, règles d'appareil) ont été recréés et testés.
  • dig CNAME go.example.com +short renvoie le edge Elido et HTTPS se charge sans avertissement de certificat.
  • Les QR codes et supports imprimés qui utilisent l'ancien domaine se résolvent toujours.
  • Un clic de test apparaît dans les analyses Elido.
  • Le CSV Short.io avec les totaux de clics est archivé dans un endroit durable.
  • Les webhooks, pixels et URL de base des SDK pointent désormais vers Elido.

Tous les comptes ne devraient pas migrer. Si vous n'utilisez qu'un sous-domaine Short.io, une migration change chaque URL publique, et le travail est plus important que ce que laisse penser l'importeur. Les articles de comparaison vous aident à décider : Elido vs Short.io, la liste plus large des alternatives à Short.io, et les face-à-face Short.io vs Bitly et Short.io vs Rebrandly. Si vous pesez un autre outil source, le guide TinyURL suit la même structure.

Prêt à essayer d'abord sur un petit domaine ? Lancez l'import Short.io avec un domaine de test, comparez les résultats à votre CSV, et décidez du reste à partir de là.

Sur le même sujet sur le blog

Questions fréquentes

Comment exporter mes liens depuis Short.io ?

Short.io documente deux exports CSV : sélectionnez des liens dans le menu Branded links et cliquez sur Export, ou ouvrez les réglages du domaine et choisissez Export links pour recevoir un fichier par e-mail. Short.io indique que la fonctionnalité n'est pas activée par défaut, donc vous contactez d'abord leur support. L'API est l'alternative et ne demande aucune approbation.

Puis-je garder mon domaine personnalisé en quittant Short.io ?

Oui, si vous possédez le nom d'hôte. Ajoutez-le à Elido, importez-y les liens, puis modifiez l'enregistrement DNS chez votre registrar. Les anciennes URL courtes continuent de fonctionner car le nom d'hôte pointe désormais vers Elido. Les sous-domaines Short.io comme example.short.gy restent chez Short.io.

Elido importe-t-il les dossiers Short.io ?

Pas en tant que dossiers. L'importeur lit la destination, le slug, le titre et les tags de chaque lien et ajoute un tag imported:shortio. L'affectation aux dossiers ne fait pas partie de cette charge utile, donc reconstruisez les dossiers dans la liste des liens Elido et servez-vous des tags pour retrouver ce qui va où.

Puis-je déplacer mon historique de clics Short.io ?

Non. L'importeur crée des liens, pas des événements de clic. L'export CSV de Short.io inclut une colonne clicks avec un total par lien, qu'il vaut la peine d'archiver, et Short.io propose sur demande un export de statistiques S3 sur les offres Enterprise. Les nouveaux clics dans Elido comptent à partir de la bascule.

Combien de temps prend un import Short.io ?

L'importeur lit 150 liens par requête et s'arrête à 50 000 liens ou 30 minutes par exécution. Quelques milliers de liens se terminent généralement en quelques minutes, selon la vitesse de réponse de Short.io. Les domaines plus gros doivent être scindés.

Les liens Short.io protégés par mot de passe ou expirants migrent-ils ?

L'importeur ne lit ni les mots de passe, ni les dates d'expiration, ni le cloaking, ni les cibles par appareil. Dressez la liste de ces liens depuis l'API Short.io avant la bascule et recréez le comportement dans Elido, par exemple avec des règles de liens intelligents et l'expiration de lien.

Essayer Elido

Collez une URL, obtenez un lien court

Sans inscription. Lien actif 30 jours. Inscrivez-vous pour le garder pour toujours.

Gratuit, sans inscription · 2 par jour

Essayer Elido

Raccourcisseur d'URL hébergé en UE : domaines personnalisés, analyses approfondies et API ouverte. Forfait gratuit - sans carte bancaire.

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

Lire la suite