Migreren van Rebrandly: export, import, DNS-cutover

Om van Rebrandly te migreren doe je drie dingen: je links via de Rebrandly API ophalen, elke slashtag opnieuw aanmaken op een domein dat je in Elido beheert en daarna de DNS van dat domein naar Elido laten wijzen. De ingebouwde Rebrandly-importer van Elido regelt de eerste twee voor de velden die hij ondersteunt (slashtag, bestemming, titel, tags). De derde, plus klikgeschiedenis en routeringsregels, is aan jou.

Het deel dat mensen verrast, is het domein. Links op je eigen hostnaam kunnen hun exacte URL's houden. Links op rebrand.ly kunnen dat niet, omdat je die host niet bezit. Deze gids scheidt de twee gevallen, somt op wat elke kant echt exporteert en importeert en eindigt met een verificatiechecklist die je kunt doorlopen voordat je iets opzegt. Alles over Elido hieronder is gecontroleerd tegen de importerbron en het dashboard; alles over Rebrandly komt uit het eigen helpcentrum en de ontwikkelaarsdocumentatie, bekeken op 2026-10-02.

Wat je uit Rebrandly kunt exporteren

Rebrandly stelt je links beschikbaar via zijn REST API, en dat is het exportpad dat de migratietools (die van Elido inbegrepen) gebruiken. GET /v1/links geeft maximaal 25 links per pagina terug, sorteert standaard op createdAt en kan filteren op domain.id of domain.fullName. De paginering is cursorachtig: je geeft de id van de laatste link die je hebt ontvangen mee als parameter last, zoals de documentatie over paginering beschrijft. Elk linkobject bevat slashtag, destination, shortUrl, een domain-object en createdAt/updatedAt.

Het helpcentrum van Rebrandly is minder gul met bestanden. Het artikel over links naar een nieuw domein verplaatsen zegt dat er geen ingebouwde schakelaar is; de voorgestelde omweg is links via de API naar CSV te exporteren, de domeinkolom te bewerken en opnieuw te importeren. De importgids behandelt de andere richting (CSV tot 400.000 links per bestand, eigen domein vereist). Reken dus op de API en bewaar je eigen JSONL-kopie als audittrail:

# Dump every link to links.jsonl (25 per page, cursor = id of last link)
last=""
while :; do
  page=$(curl -s -H "apikey: $REBRANDLY_KEY" \
    "https://api.rebrandly.com/v1/links?limit=25&orderBy=createdAt&orderDir=asc${last:+&last=$last}")
  [ "$(echo "$page" | jq 'length')" -eq 0 ] && break
  echo "$page" | jq -c '.[]' >> links.jsonl
  last=$(echo "$page" | jq -r '.[-1].id')
done
wc -l links.jsonl

Bij de gedocumenteerde standaard van tien aanroepen per seconde voor standaardabonnementen is zelfs een account met 20.000 links een korte klus. Het bestand is ook je baseline voor de verificatiestap later. Ik kon uit de openbare documentatie niet bevestigen welke klik- of per-klikvelden elk abonnement teruggeeft, dus open één echt record voordat je iemand historische analytics belooft.

Wat verhuist en wat blijft: rebrand.ly versus je eigen domein

Kort antwoord: het pad verhuist, de host alleen als hij van jou is. Een link als go.acme.com/summer kan na de cutover ongewijzigd blijven werken. Een link als rebrand.ly/summer kan dat niet, omdat die hostnaam van Rebrandly is en via hun dienst blijft resolven zolang je account bestaat.

Drie gevallen dekken de meeste accounts:

• Je eigen domein, DNS onder jouw beheer. Het beste geval. Maak elke slashtag opnieuw aan op dezelfde hostnaam in Elido en laat daarna DNS ernaar wijzen. Gedrukte QR-codes, e-mailarchieven en bio's blijven werken.
• Een domein dat je via Rebrandly hebt gekocht. Je kunt het naar een andere registrar verplaatsen. Het helpartikel van Rebrandly zegt dat je Transfer out gebruikt, dan per e-mail een code aanvraagt, en merkt op dat de meeste domeinen na registratie een vergrendeling van 60 dagen hebben. Start die klok vroeg. De pagina zegt niet wat er tijdens een transfer met links gebeurt, dus beschouw de CNAME-wijziging als de veiligere eerste zet en de registrartransfer als een latere stap.
• Het gratis domein rebrand.ly. Links behouden hun slashtags op een nieuwe host, maar de oude URL's blijven bij Rebrandly. Staan ze in druk, houd het Rebrandly-account dan actief zolang dat materiaal in omloop is, en werk de plekken bij die je kunt bereiken.

Een 301 van een oude host naar een nieuwe is de standaardmanier om gebruikers over te zetten, en RFC 9110 sectie 15.4.2 vertelt clients dat ze opgeslagen verwijzingen mogen bijwerken. Dat helpt alleen als je de oude hostnaam nog beheert. Voor de beslissing of je de oude host in leven houdt, gelden dezelfde afwegingen als in de Bitly-migratieplaybook.

Mapping van velden, tags en werkruimtes

De importer is bewust smal. Hij leest vier dingen uit elke Rebrandly-link (slashtag, bestemming, titel, tags), schrijft ze naar een Elido-link op het domein dat je hebt gekozen en voegt één tag toe. Al het andere vraagt om je eigen script of een handmatige stap.

Twee details verdienen een tweede blik. Ten eerste de aanmaakdatums: de oudere versie van deze gids suggereerde dat het bulk-endpoint ze behoudt. Dat doet het niet (POST /v1/workspaces/{id}/links/bulk neemt slug, bestemming, titel en tags, 100 links per request), dus geïmporteerde links sorteren op importdatum. Zijn de oorspronkelijke datums voor rapportage van belang, bewaar dan het JSONL-bestand. Ten tweede de werkruimtes: de API accepteert een Rebrandly-filter workspace_id, maar het importformulier in het dashboard toont op dit moment alleen de sleutel, het doeldomein en de conflictstrategie. Een bureau met meerdere klantwerkruimtes moet de job ofwel via de API met een werkruimtefilter draaien of per run één sleutel aanmaken.

Bij mappen is voorzichtigheid geboden. Elido heeft mappen in de linklijst, maar de importer maakt ze niet aan. Heeft Rebrandly je links per map of per werkruimte georganiseerd, neem die structuur dan als tags over in je eigen voorbewerking (client:acme, campaign:summer) en pas ze toe met een bulk-aanroep, of voeg ze achteraf toe door te filteren op imported:rebrandly en bulk-tagbewerkingen te gebruiken.

De linklijst in een DEMO-werkruimte met voorbeelddata (synthetische cijfers, geen klantresultaten). Geïmporteerde links verschijnen hier met hun tags, waaronder imported:rebrandly.

De Rebrandly-importer van Elido draaien

De importer staat in het dashboard onder Integrations, dan Rebrandly to Elido (ook beschikbaar als POST /v1/workspaces/{id}/imports/rebrandly). Voeg eerst het doeldomein toe aan je werkruimte zodat het in de keuzelijst verschijnt en volg dan de flow.

1. Maak de sleutel aan in Rebrandly onder Account, dan API. Leestoegang is alles wat de job nodig heeft.
2. Plak de sleutel in het Rebrandly-formulier. Elido bewaart hem tijdens de run in het procesgeheugen en laat hem daarna vallen; hij wordt niet naar het jobrecord geschreven.
3. Kies het doeldomein. Elke link die de sleutel kan zien, landt op dit ene domein. Er is geen filter per domein, dus een account met meerdere Rebrandly-domeinen en overlappende slashtags krijgt botsingen.
4. Kies een conflictstrategie: suffix (mylink wordt mylink-2), skip, of fail bij het eerste conflict.
5. Start de job en volg de tellers. De pagina pollt elke twee seconden, en je kunt hem open laten staan of sluiten.

Limieten die het weten waard zijn: de worker pagineert door Rebrandly met 25 links per request, begrenst een job op 50.000 links en geeft het na 30 minuten op. Overgeslagen en mislukte rijen worden naar het foutenlogboek van de job geschreven (de eerste 1.000 items). Een slug met suffix wordt niet als probleem gelogd, maar is wel een gewijzigde URL, dus gebruik bij een overdracht op hetzelfde domein skip of fail op een leeg doeldomein en behandel elk aantal overgeslagen of mislukt dat niet nul is als werk dat nog moet gebeuren. Heeft je account meerdere domeinen, begin dan met skip en lees het logboek voordat je beslist wat je met de overlap doet. Voor fijnmazige controle gebruik je in plaats daarvan je JSONL-bestand en het bulk-endpoint: dat neemt tot 100 links per aanroep en meldt succes of fout per rij.

Wil je het formulier zien voordat je DNS aanraakt? Het staat in dezelfde catalogus als de andere vier migratiebronnen.

De pagina Integrations in een DEMO-werkruimte met voorbeelddata. Het filter Migration groepeert de importers voor Rebrandly, Bitly, Short.io, TinyURL en Dub.

Klaar om het op een testbatch te draaien? Maak een Elido-werkruimte en laat de Rebrandly-importer eerst naar een reservedomein wijzen; de stapsgewijze landingspagina somt dezelfde meegenomen en achtergelaten items op.

Cutoverplan voor een domein dat je bezit

De volgorde doet ertoe, want Elido verifieert een domein via twee DNS-records en je live verkeer verandert pas wanneer het tweede verandert. De verifier zoekt een TXT-record op _elido-verify.<hostname> met de waarde verify=<token>, en een CNAME van de hostnaam naar het edge-doel van Elido (standaard edge.elido.me). De details van de opzet staan in eigen domeinen voor korte links en op de functiepagina over eigen domeinen.

1. Twee dagen vooraf. Verlaag de TTL op de huidige CNAME naar 300 seconden. Voeg het domein toe in Elido en publiceer het TXT-record. Dit raakt het live verkeer niet.
2. Importeren. Draai de importer naar dat domein en vergelijk dan het aantal geïmporteerde links met wc -l links.jsonl.
3. Cutovervenster. Wijzig de CNAME naar het edge-doel van Elido. Elido pollt beide records en geeft het certificaat automatisch uit, zoals behandeld in TLS voor een eigen domein in vijf minuten.
4. Resolvercontrole. Vraag minstens twee openbare resolvers af, bijvoorbeeld dig @8.8.8.8 go.acme.com CNAME en dig @1.1.1.1 go.acme.com CNAME, want je eigen machine bewijst alleen je eigen cache.
5. Laat Rebrandly met rust. Verwijder het domein of het account nog niet. Terugdraaien is een CNAME-wijziging van één regel zolang de oude opzet nog bestaat.

Integraties zijn het stille deel van elke overstap. Als Zapier, Make of een intern script Rebrandly-links aanmaakt, laat ze dan pas na bevestiging van de import ergens anders naartoe wijzen, niet eerder, anders maak je slugconflicten. De Elido API accepteert hetzelfde paar van slug en bestemming.

Verificatiechecklist

Kondig de verhuizing niet aan op basis van een groen jobscherm. Voer deze controles uit en schrijf de resultaten op.

• Geïmporteerd plus overgeslagen plus mislukt is gelijk aan het aantal regels in je JSONL-bestand (min links op domeinen die je bewust hebt achtergelaten).
• Overgeslagen en mislukt zijn nul, of elk item in het foutenlogboek is verklaard.
• Geen enkele slug eindigde op een suffix in de stijl -2 die er in Rebrandly niet was. Filter Links op imported:rebrandly en loop ze langs.
• Je top 100 links op verkeer sturen correct door. Vergelijk voor elk de header Location met de bestemming in je JSONL:

while read -r slug dest; do
  got=$(curl -s -o /dev/null -w "%{redirect_url}" "https://go.acme.com/$slug")
  [ "$got" = "$dest" ] || echo "MISMATCH $slug -> $got (expected $dest)"
done < top100.tsv

• Slashtags in gemengde hoofdletters en slashtags met speciale tekens worden met de hand steekproefsgewijs gecontroleerd. Ik heb niet getest hoe elke randgeval-slug de reis overleeft, dus neem zelf steekproeven.
• Eén QR-code uit druk wordt op een telefoon gescand, via mobiele data.
• Analytics tonen binnen het uur de eerste klikken. De klikgeschiedenis van Rebrandly blijft in Rebrandly, dus exporteer of maak screenshots van de rapporten die je nodig hebt voor een vergelijking jaar op jaar.
• Na 30 dagen zonder verrassingen downgrade je het Rebrandly-account of sluit je het.

Teams die dezelfde reeks voor een andere leverancier hebben doorlopen, zullen hem herkennen; de gids Bitly-migratie zonder gebroken links behandelt de gedeelde mechanica, en de TinyURL-migratie toont hetzelfde importerpatroon voor een andere bron.

Beperkingen en wanneer je niet moet overstappen

De importer bouwt de apparaat- of geo-routeringsregels van Rebrandly, UTM-sjablonen of QR-opmaak niet opnieuw op, en hij kopieert geen teamlidmaatschap. Dat zijn handmatige herbouwen. De Rebrandly-importers van Dub en Fynlink vermelden apparaat- en geotargeting ook als niet gemigreerd, dus dit is typerend voor importers, geen gat dat uniek is voor Elido.

Leunt je Rebrandly-opzet zwaar op routeringsregels of QR-branding op linkniveau, draai de twee producten dan een maand parallel voordat je je vastlegt. Voor een vergelijking van functies en prijzen, lees Elido versus Rebrandly of de bredere lijst met Rebrandly-alternatieven. Het technische verhaal van de worker zelf staat in de Rebrandly-migratieworker opleveren.

Gerelateerd op de blog

• De Rebrandly-migratieworker opleveren
• Elido vs Rebrandly: prijzen, EU-residentie en branded links in 2026
• Rebrandly-alternatieven: 9 tools voor branded links gerangschikt
• Bitly vs Rebrandly: branded links, prijzen en geschiktheid
• Bitly-migratieplaybook: van inventaris tot 30 dagen monitoring
• Branded korte links instellen: kies een domein en lever in een middag op