Dub.co-migratie naar Elido: wat de importer echt doet

De Dub.co-importer van Elido leest je links via de REST API van Dub, 100 per verzoek, en maakt ze aan op één Elido-domein met dezelfde slug. Hij neemt de slug, bestemmings-URL, titel en tagnamen mee. Hij neemt geen mappen, gearchiveerde links, klikgeschiedenis of linkinstellingen mee. Dat zijn de feiten die tellen als je een verhuizing plant.

Een eerdere versie van dit artikel beweerde dat Dub-mappen worden platgeslagen tot tags. Ik heb de importer voor deze update opnieuw gelezen en dat klopte niet: de code leest mappen nooit. Deze versie beschrijft wat services/api-core/internal/imports/dub.go nu doet, gecontroleerd aan de hand van de gepubliceerde API-specificatie van Dub (geraadpleegd op 2026-10-02).

Wat de importer aan Dub vraagt

De worker stuurt GET https://api.dub.co/links?page=N&pageSize=100 met jouw key als bearer-token. Volgens de documentatie over API-keys van Dub (geraadpleegd op 2026-10-02) is een key aan één workspace gebonden en kan hij alleen-lezen worden aangemaakt. Een alleen-lezen key is alles wat deze import nodig heeft, omdat de worker alleen links opsomt en nooit naar Dub schrijft.

Het antwoord is een gewone JSON-array. Er is geen vlag "heeft meer", dus de worker blijft pagina's opvragen tot er een binnenkomt met minder dan 100 items, of een lege:

if len(links) == 0 { break }
// ... import each link ...
if len(links) < dubPageSize { break } // last page
page++

Eén kanttekening uit de eigen specificatie van Dub: de parameter page is als verouderd gemarkeerd ten gunste van cursorpaginering met startingAfter. Hij werkt nu nog, en pageSize accepteert tot 100. Als Dub page verwijdert, heeft de importer een kleine aanpassing nodig, en ik verwacht dat dat zich toont als een mislukte job met een duidelijke HTTP-fout in plaats van stil dataverlies.

De pagina over rate limits van Dub (geraadpleegd op 2026-10-02) noemt 60 verzoeken per minuut op het gratis abonnement en 600 op Pro. De importer voegt links tussen de verzoeken door één voor één in Postgres in, dus hij komt in de praktijk niet in de buurt van de gratis limiet. Hij heeft ook geen retry: een HTTP 429 of elk ander antwoord dan 200 beëindigt de job als mislukt, met de statuscode in de melding.

Wat in Elido terechtkomt, veld voor veld

Al het andere op een Dub-link valt van tafel: beschrijving, voorbeeldafbeelding voor social media, vervaldatum, wachtwoord, geo- en apparaattargeting, UTM-velden, iOS- en Android-doelen, vlaggen voor conversietracking. Hangt een link van een van die zaken af, bouw hem dan na de import opnieuw op. Elido heeft eigen smartlinkregels voor targeting, maar niets zet de regels van Dub automatisch over.

Mappen, gearchiveerde links en domeinen

Drie Dub-concepten worden niet afgehandeld, en elk kan je verrassen.

Mappen. In het linkschema van Dub verschijnt een map alleen als een folderId-string. De importer heeft er geen veld voor en doet geen tweede aanroep om mapnamen op te lossen. Elido heeft tags, geen mappen, dus zelfs een toekomstige importer zou ze moeten platslaan. Nu gaat de mapstructuur verloren. Als dat ertoe doet, noteer dan de map bij elke slug voordat je begint, en tag daarna de geïmporteerde batch (filter op imported:dub) met de hand of via de API.

Gearchiveerde links. Het list-endpoint van Dub kent een parameter showArchived die standaard false is. De importer zet hem nooit, dus gearchiveerde links worden niet teruggegeven en niet geïmporteerd. Dat is een redelijke standaard voor een migratie, maar je moet het weten als je oude campagnelinks bewust gearchiveerd houdt.

Linkdomeinen. Een Dub-workspace kan links op meerdere domeinen bevatten. De importer leest ze allemaal, negeert het veld domain en maakt elke link aan op het ene Elido-domein dat je kiest. Als twee Dub-domeinen dezelfde key gebruiken, stuit de tweede op een conflict. De conflictstrategie bepaalt wat er dan gebeurt, dus kies hem met dat in gedachten.

Conflicten, limieten en het workercontract

Je kiest een conflictstrategie wanneer je de job start:

• suffix probeert mylink-2, mylink-3 enzovoort tot -50, geeft die link dan op en telt hem als mislukt.
• skip laat de bestaande Elido-link met rust en logt de slug als overgeslagen.
• fail stopt de hele job bij het eerste conflict.

Per run stopt de worker bij 50.000 links (MaxLinksPerImport) of na 30 minuten (ImportRunBudget), wat het eerst komt. De voortgang wordt elke 50 links opgeslagen en het dashboard pollt hem. Het foutenlog bewaart maximaal 1.000 items. Elke slugcontrole is één geïndexeerde lookup op (domain_id, slug).

Ik heb Dub-imports niet gebenchmarkt tegen een groot account, dus ik noem geen cijfer voor links per minuut. De lus is één HTTP-pagina van 100 links gevolgd door 100 opeenvolgende inserts, dus de duur schaalt met hoe snel Dub antwoordt en met je database. Test eerst met een kleine workspace.

Tokenafhandeling en wat er bij een deploy gebeurt

De key reist mee in de requestbody van POST /imports/dub, wordt in het geheugen van de draaiende worker bewaard en wordt nooit opgeslagen: de source_token_id van de jobrij blijft leeg. Alleen de optionele workspace_id-tekst komt in de kolom source_filter van de job.

De worker draait in een goroutine die met context.WithoutCancel is losgekoppeld van het HTTP-verzoek. Dat houdt hem in leven na het antwoord, en het betekent ook dat een deploy of herstart hem halverwege een run beëindigt. Een schedulerjob draait elke 5 minuten en markeert elke running-import zonder voortgang gedurende 30 minuten als mislukt. Opnieuw draaien is veilig onder suffix (je krijgt -2-kopieën van alles wat al is geïmporteerd) en onder skip (reeds geïmporteerde slugs worden overgeslagen). Er wordt nog niets hervat vanaf de laatste pagina.

De linklijst in een demo-workspace met synthetische data. Filter na een import op de tag imported:dub om de batch te vinden.

Een korte checklist voordat je draait

1. Maak een alleen-lezen API-key aan in je Dub-workspace.
2. Haal gearchiveerde links die je wilt houden uit het archief en noteer de mapstructuur waarop je leunt.
3. Voeg het doeldomein toe in Elido en kies skip of suffix in de wetenschap dat alle Dub-domeinen in dit ene domein samenvallen.
4. Draai de import vanaf de integratiepagina in het dashboard, of via POST /imports/dub met token, target_domain_id en conflict_strategy.
5. Controleer steekproefsgewijs slugs en bestemmingen tegen Dub en werk daarna de DNS bij voor elk eigen domein dat je bezit. Het cutoverplaybook voor Bitly behandelt de DNS-volgorde, die voor elke leverancier hetzelfde is.

Als je nog twijfelt of je wel wilt verhuizen, vergelijkt Elido vs Dub abonnementen en functies, en legt GDPR voor URL-verkorters de kant van dataresidentie uit. De leveranciersgerichte uitleg staat op de Dub-migratiepagina.

Gerelateerd op de blog

• Elido vs Dub: SSO, conversietracking, EU-residentie
• Dub-alternatieven: 6 linkbeheerplatforms vergeleken
• De Bitly-migratie opleveren: een worker, een token, een budget van 30 minuten
• De Rebrandly-migratie opleveren: paginering met 25 per pagina
• De Short.io-migratie opleveren: paginering per domein met 150 per pagina