Short.io-migratie: export, import, cutoverchecklist

Een Short.io-migratie heeft vier delen: je links eruit halen, bepalen hoe domeinen, mappen en tags in de nieuwe tool terechtkomen, de DNS verplaatsen en bewijzen dat er niets kapot is gegaan. Elido kan links rechtstreeks uit de Short.io API ophalen, dus een CSV is niet nodig, maar de importer heeft beperkingen die je moet kennen voordat je begint. Deze gids behandelt de exportopties die Short.io documenteert, wat de Elido-importer meeneemt en laat vallen, een cutovervolgorde die downtime voorkomt en een verificatiechecklist.

De feiten over Short.io hieronder komen uit de eigen documentatie van Short.io, bekeken op 2026-10-02. Het gedrag van Elido is gecontroleerd tegen de importerbron en het dashboard, niet tegen een marketingpagina.

Short.io-exportopties in één oogopslag

Je hebt drie manieren om je linklijst uit Short.io te halen. Welke je kiest, bepaalt wat overleeft.

Het list-endpoint is de rijkste bron. Het filtert op domein, map en datumbereik, sorteert op aanmaakdatum en geeft een nextPageToken terug voor paginering. Dat maakt het de juiste tool voor een audit van de dingen die de importer niet meeneemt, het deel dat de meeste gidsen overslaan.

Short.io heeft ook een CSV-importer voor de andere richting, met kolommen voor URL, slug, tags, titel en aanmaakdatum (importgids). Wil je het liever scripten, dan heeft Elido een API-endpoint voor het in bulk aanmaken van links, en de CSV-kolommen hierboven mappen naar bestemming, slug, titel en tags.

Stap 1: audit voordat je iets verplaatst

Voer eerst een audit van het brondomein uit. Ik zou deze stap niet overslaan: hij is goedkoop en het is de enige manier om te leren welke links handwerk nodig hebben voordat bezoekers het merken.

1. Exporteer de CSV of loop de API door en tel de links per domein. Vergelijk met de limiet van 50.000 per run.
2. Filter op links met een expiresAt, een password, cloaking: true, apparaat-URL's (androidURL, iphoneURL) of een gesplitste URL. Dit zijn de links die de importer als gewone redirects opnieuw aanmaakt.
3. Noteer het redirecttype. Short.io laat je per link 301, 302, 307 of 308 kiezen. De importer leest het niet, dus bepaal wat je op Elido wilt. De afwegingen staan in 301 vs 302 redirects.
4. Archiveer de kolom met klikken. Bewaar de CSV; het is het enige overzicht van totalen per link zodra je opzegt.

Domeinen en mappen: hoe de mapping werkt

Short.io organiseert alles onder een domein. Elido organiseert onder een werkruimte, en een werkruimte bezit de domeinen.

• Eigen domein dat je bezit: voeg het toe aan de werkruimte en wijzig zelf de DNS. De importer doet dit niet.
• Short.io-subdomein: links worden geïmporteerd op een nieuw Elido-domein, maar de oude URL's op dat subdomein resolven niet meer.
• Map: bouw na de import opnieuw op als map in de linklijst. Niet meegenomen door de importer.
• Tag: meegenomen, plus een tag imported:shortio.
• Pad (slug): meegenomen, met een voorafgaande / verwijderd.

Twee details doen hier ertoe. Ten eerste importeert de importer per job één Short.io-domein naar één Elido-domein. Draai je drie domeinen, dan start je drie jobs, een voor een. Ten tweede stelt de importer geen map in. Het praktische patroon is de linklijst van Elido te filteren op een Short.io-tag, de links te selecteren en naar een map te verplaatsen. Waren mappen je belangrijkste ordeningsmiddel bij Short.io, zet elke map dan vóór de import in Short.io om naar een tag, zodat de tag met de link meereist.

De linklijst van Elido in een DEMO-werkruimte met voorbeelddata (alle cijfers zijn synthetisch). Tags en de kolom Map zijn waar geïmporteerde Short.io-metadata terechtkomt.

De Elido-importer draaien

De importer staat in het dashboard onder Integrations, dan Short.io. De integratiepagina en de landingspagina migreren van Short.io beschrijven dezelfde flow.

1. Maak in Short.io een geheime API-sleutel aan onder Integrations en API. De importer leest alleen.
2. Open in Elido de migratiekaart voor Short.io en plak de sleutel. De kaart vermeldt dat de sleutel nooit wordt opgeslagen: hij blijft voor de run in het geheugen en wordt weggegooid wanneer de job eindigt.
3. Typ de hostnaam van het Short.io-domein waaruit je importeert, bijvoorbeeld example.short.gy.
4. Kies het Elido-doeldomein, dat al aan je werkruimte moet zijn toegevoegd.
5. Kies een conflictstrategie en start. De job pollt zijn eigen voortgang elke twee seconden in het dashboard.

De drie conflictstrategieën gedragen zich zo. Suffix hernoemt een botsende slug naar name-2, name-3 enzovoort. Skip laat de bestaande Elido-link met rust en logt de bronrij. Fail stopt de hele job bij de eerste botsing. Suffix is de veilige standaard voor een eerste run naar een leeg domein; gebruik skip bij een herhaalde run na een gedeeltelijke import.

Onder de motorkap vraagt de worker 150 links per pagina op en volgt het nextPageToken van Short.io tot het op is. Een run is begrensd op 50.000 links en 30 minuten, de voortgang wordt elke 50 links teruggeschreven en het foutenlogboek bewaart de eerste 1.000 probleemrijen. Een link zonder bestemmings-URL of met een lege slug wordt als mislukking vastgelegd en de run gaat door. Titels worden afgekapt op 200 tekens.

Controleer het eerste resultaat voordat je het tweede domein vertrouwt. Open een handvol geïmporteerde links, vergelijk slug en bestemming met de Short.io-CSV en zet daarna pas de volgende job in de wachtrij.

Wat niet meekomt

Wees expliciet over deze lijst in je projectplan. De importer leest alleen de velden uit de eerste tabel hierboven.

• Wachtwoorden, vervaldatums, cloaking, apparaat-URL's en splittests. Ze komen aan als gewone redirects. Bouw geo- en apparaatroutering opnieuw op als regels voor slimme links. Links in Elido hebben ook eigen velden voor verloop en wachtwoord, dus stel die in vanuit je auditlijst.
• Mappen. Met de hand opnieuw opbouwen, zie hierboven.
• Redirecttype. Stel het opnieuw in als je op het gedrag van 301 versus 302 leunt.
• Gearchiveerde status. De importer controleert die niet. Verifieer gearchiveerde links in je CSV tegen wat in Elido verschijnt.
• Pixels en webhooks. Die worden in Short.io los van de links geconfigureerd. Maak ze opnieuw aan in de Elido-werkruimte en geef webhook-secrets opnieuw uit, want handtekeningen verschillen tussen de twee producten.
• Klikgeschiedenis. Zie de volgende sectie.

Wat er met de analyticsgeschiedenis gebeurt

De geschiedenis per klik verhuist niet. De importer maakt links aan en niets anders, dus Elido begint te tellen vanaf de eerste klik die hij serveert. Dit geldt voor elke importer in het Elido-dashboard en voor de meeste tools in de categorie.

Je hebt twee eerlijke opties. Bewaar de Short.io-CSV, die een kliktotaal per link bevat, en archiveer hem met de cutoverdatum als baseline. Of, als je een Enterprise-abonnement hebt, vraag Short.io om de S3-statistiekexport, die Short.io op verzoek aanbiedt. Na de cutover toont de analyticsweergave klikken per dag, landen, referrers en hosts voor de hele werkruimte.

Het analytics-overzicht van Elido in een DEMO-werkruimte met voorbeelddata (synthetische cijfers, geen klantresultaten). Na de cutover bevat deze weergave alleen klikken die door Elido zijn geserveerd.

Cutover: een veilige volgorde voor eigen domeinen

Links op een hostnaam die je bezit, kunnen verhuizen zonder dat iemand het merkt, als je de volgorde aanhoudt. Links op een Short.io-subdomein kunnen dat niet, omdat je die DNS-naam niet beheert.

1. Voeg de hostnaam eerst toe aan Elido. Voeg hem toe onder eigen domeinen, publiceer het TXT-verificatierecord en wacht op verificatie. De mechanica staat in TLS voor een eigen domein in 5 minuten en op de functiepagina over eigen domeinen.
2. Importeer op die hostnaam terwijl Short.io nog productieverkeer serveert. Voor bezoekers verandert er nog niets.
3. Verifieer links op Elido door slugs tegen de nieuwe edge te testen voordat DNS verandert (zie de checklist hieronder).
4. Verlaag de TTL van het bestaande record een dag van tevoren, zodat de omschakeling snel doorwerkt.
5. Wijzig het record. De gids van Short.io gebruikt een A-record op de root (207.174.61.1 bij het bekijken). Elido gebruikt een CNAME naar edge.elido.me. Een CNAME mag niet op de kale apex staan (RFC 1034), dus voor een apex-hostnaam heb je ALIAS of CNAME-flattening bij je DNS-provider nodig, of je stapt over op een subdomein.
6. Houd Short.io een factureringscyclus actief als rollback. Als er iets mis lijkt, draai je het record terug.

Als je ook om zoek- en verwijzingsverkeer geeft, controleer dan dat je oude korte URL's in één hop resolven. Ketens kosten tijd en worden behandeld in redirectketens en SEO.

Verificatiechecklist

Voer dit uit nadat DNS is doorgevoerd, op een steekproef van minstens 50 links, of op alle links als je er minder hebt.

• Het aantal geïmporteerde links komt overeen met het aantal in de bron, nadat overgeslagen en mislukte rijen uit het foutenlogboek van de job zijn verrekend.
• Tien willekeurige slugs geven dezelfde bestemming als de Short.io-CSV.
• Links die je in de audit hebt gemarkeerd (verloop, wachtwoord, apparaatregels) zijn opnieuw aangemaakt en getest.
• dig CNAME go.example.com +short geeft de Elido-edge terug en HTTPS laadt zonder certificaatwaarschuwing.
• QR-codes en drukwerk die het oude domein gebruiken, resolven nog.
• Een testklik verschijnt in de analytics van Elido.
• De Short.io-CSV met kliktotalen is op een duurzame plek gearchiveerd.
• Webhooks, pixels en SDK-basis-URL's wijzen nu naar Elido.

Niet elk account moet verhuizen. Gebruik je alleen een Short.io-subdomein, dan verandert een migratie elke openbare URL en is het werk groter dan de importer doet vermoeden. De vergelijkingsberichten helpen je beslissen: Elido vs Short.io, de bredere lijst met Short.io-alternatieven en de directe vergelijkingen Short.io vs Bitly en Short.io vs Rebrandly. Overweeg je een andere brontool, dan volgt de TinyURL-playbook dezelfde structuur.

Eerst op een klein domein proberen? Start de Short.io-import met een testdomein, controleer de resultaten tegen je CSV en beslis daarna over de rest.

Gerelateerd op de blog

• Elido vs Short.io: prijzen, teams en EU-residentie in 2026
• Short.io-alternatieven
• Short.io vs Bitly
• Short.io vs Rebrandly
• TLS voor een eigen domein in 5 minuten
• Migreren van TinyURL: wat meegaat, wat blijft, wat breekt