6 min leestijdTutorials

Korte link werkt niet? Diagnosticeer het met één commando

Een korte link die een 404 geeft, een certificaatwaarschuwing toont, of in de ene app opent en niet in de andere, heeft vier mogelijke oorzaken. Lees de response headers en los de juiste op.

Marius Voß
DevRel · edge infra
Korte link werkt niet: de response headers van een korte URL lezen om een 404 te onderscheiden van een certificaatfout, een blokkade in een app, en een redirectlus

Een korte link die niet werkt, faalt op een van vier manieren, en die hebben niets met elkaar te maken. Voer curl -sI erop uit en de eerste regel vertelt je welke van de vier je hebt:

curl -sI https://s.elido.me/ab12cd

Een 301 met een Location header betekent dat de link gezond is en het probleem verderop zit. Een 404 betekent dat de slug verkeerd is, verwijderd, of in de verkeerde hoofdletters staat. Een TLS-fout nog vóór er enige HTTP plaatsvindt, betekent dat het domein niet af is. En een 200 die een waarschuwingspagina toont, betekent dat iets tussen jou en de link heeft besloten hem niet door te laten.

Tien seconden in een terminal verslaan een uur giswerk, omdat een browser alle vier samenperst tot dezelfde onbehulpzame foutpagina. Dit artikel loopt elke oorzaak en de bijbehorende oplossing langs.

Vier faalsymptomen van een korte link met oorzaken en oplossingen: een 404 van het domein, een certificaatwaarschuwing, een blokkade in een app, en een redirectlus

Een 404 van het korte domein

Het domein heeft geantwoord, dus DNS en TLS zijn in orde. De slug is het probleem.

Controleer eerst de hoofdletters. De meeste shorteners behandelen slugs als hoofdlettergevoelig, dus /Spring en /spring zijn twee verschillende links en bestaat er maar één van. Als de link van een gedrukte flyer komt, wees dan achterdochtig over de tekens die op elkaar lijken in een schreefloos lettertype: hoofdletter I, kleine letter l, en het cijfer 1; hoofdletter O en nul. Dat is het sterkste argument voor aangepaste back-halves die uit echte woorden bestaan in plaats van willekeurige tekens.

Als de slug klopt, controleer dan of de link is verwijderd of gearchiveerd, en of hij een vervaldatum heeft. Linkvervaldatum en zelfvernietigende links behandelt hoe een geplande vervaldatum zich gedraagt zodra die afgaat: de link werkt niet meer en lijkt voor wie hem aanklikt precies op een typefout.

Nog een mogelijkheid bij een link die vroeger wel werkte: een geo- of apparaatregel die de plek waar je test uitsluit. Smart links routeren op land en apparaat, en een regel zonder fallback is voor iedereen buiten de lijst een 404.

Een certificaatwaarschuwing op een aangepast domein

Hier is helemaal geen HTTP gebeurd. De browser weigerde tijdens de TLS-handshake, wat betekent dat het domein serveert voordat het certificaat bestaat.

Twee oorzaken dekken bijna elk geval. Het DNS-record is toegevoegd, maar de verificatie is nooit voltooid, waardoor het certificaat nooit is uitgegeven. Of het domein is gewezen met een A-record terwijl de provider om een CNAME vroeg, en de challenge die eigenaarschap bewijst kan niet worden voltooid.

De oplossing is het record precies invullen zoals het dashboard aangeeft, en dan wachten: propagatie hangt af van de vorige TTL van wat daar eerder stond, dus een record dat een TTL van een uur had, doet er tot een uur over om door te werken. Aangepaste domeinen voor korte links bevat de volledige DNS- en TLS-walkthrough, en aangepast domein TLS in vijf minuten behandelt het gunstige scenario.

De drie fasen die een korte link doorloopt, DNS, TLS, en de 301-redirect, met de fout die bij elke fase hoort

Het werkt in een browser maar niet in een app

De link werkt perfect vanuit je terminal, maar wordt in Slack, Teams, WhatsApp of een e-mailgateway gestript, gemarkeerd, of stilletjes verwijderd.

Dat ligt niet aan je link. Het ligt aan de reputatie van het domein. Gratis publieke shortenerdomeinen worden gedeeld door iedereen die ze gebruikt, inclusief de phishingcampagne die er vanochtend op draaide, en de securityleveranciers die deze apps van een blocklist voorzien, werken op domeinniveau in plaats van op slugniveau.

Er is geen instelling die dit oplost op een gedeeld domein. De oplossing is je eigen domein, waar de reputatie alleen van jou is en verbetert in plaats van willekeurig in elkaar te storten. Waarom korte links geblokkeerd worden in Slack en Teams behandelt het volledige mechanisme, inclusief wat te doen als je eigen domein toch gemarkeerd raakt.

E-mail voegt een tweede laag toe: sommige securityproducten herschrijven elke link in een bericht, zodat wat de ontvanger aanklikt de URL van de leverancier is, niet die van jou. Schaden korte links de e-mailbezorgbaarheid behandelt die interactie.

Zit je nog op een gedeeld domein, dan is dit het moment om over te stappen. Zet een merkgebonden domein op via het gratis plan en geef de links die ertoe doen opnieuw uit.

Redirectlussen en lange ketens

curl -sI toont één hop. Voeg -L toe en tel ze:

curl -sIL https://s.elido.me/ab12cd | grep -E '^HTTP|^[Ll]ocation'

Twee of drie regels is normaal: de korte link stuurt door, en de bestemming stuurt mogelijk nog een keer door van http naar https of van de apex naar www. Een muur van regels betekent een lus, en de gebruikelijke oorzaak is een link die is bewerkt zodat die naar een pagina wijst die zelf weer terug doorstuurt naar de korte URL. Wijs de bestemming naar de uiteindelijke pagina, niet naar nog een redirect.

Browsers stoppen met volgen na een vast aantal hops en tonen een generieke "te veel redirects"-pagina, wat de reden is waarom de terminal de snellere diagnose is: curl print onderweg elke Location header, zodat je precies kunt zien welke twee URL's naar elkaar wijzen. De statuscode-semantiek is vastgelegd in RFC 9110, en de praktische versie is dat een permanente redirect door de browser wordt gecachet, dus een verkeerde 301 blijft voor die bezoeker verkeerd, zelfs nadat je het hebt gerepareerd.

Lange ketens zijn de moeite van het inkorten waard, zelfs als ze werken. Elke hop voegt latency toe op een mobiele verbinding, en elke hop is weer een plek waar een querystring kan wegvallen, wat de manier is waarop UTM-parameters verdwijnen in GA4. De 301 versus 302 uitleg behandelt welke statuscode waar hoort, en soorten redirects behandelt de rest van de familie.

Wanneer de bestemming het kapotte onderdeel is

Soms is de korte link in orde en is de pagina erachter dat niet. De redirect geeft 301 terug, de browser volgt hem, en de bestemming geeft 404 terug omdat de campagnepagina offline is gehaald of de slug is veranderd.

Dit is het faalscenario waardoor korte links de moeite waard zijn, want de oplossing is een herwijzing in plaats van een herdruk. Verander de bestemming en elke plek waar de link is gepubliceerd, werkt weer, inclusief de gedrukte exemplaren. Linkrotpreventie behandelt hoe je dit opvangt voordat een klant het doet, en linkredirects monitoren met Sentry en Datadog behandelt hoe je hier op schaal meldingen voor inricht.

De volgorde om te controleren

Headers eerst, altijd. curl -sI scheidt DNS van TLS van HTTP in één regel, en elk daarvan heeft zijn eigen oplossing die niets met de andere twee te maken heeft. Dan de slug, dan de bestemming, dan de app of gateway ertussen.

De ene controle die de meeste problemen opvangt voordat iemand anders ze ziet: open elke nieuwe link één keer, op een telefoon, op mobiele data in plaats van kantoor-wifi. Het kost vijftien seconden en het vangt het certificaat dat nog niet is uitgegeven, de geo-regel zonder fallback, en de bestemming die ergens naartoe stuurt wat je niet had verwacht.

Lees de cornerstone-serie

Dit artikel valt onder de tutorials-cluster. Voor de onderliggende mechanica behandelt hoe URL-shorteners werken het redirectpad, en de beveiligingschecklist voor URL-shorteners behandelt de misbruikkant die domeinen om te beginnen laat blokkeren.

Gerelateerd op de blog

Veelgestelde vragen

Waarom werkt mijn korte link niet?

Voer curl -sI erop uit en lees de eerste regel. Een 404 betekent dat de slug verkeerd is of verwijderd, een TLS-fout betekent dat het aangepaste domein niet af is, een 200 met een waarschuwingspagina betekent dat een app of gateway hem heeft geblokkeerd, en een keten van 301's betekent dat de bestemming terugwijst naar de link. Elk heeft een andere oplossing.

Waarom zegt mijn korte link dat het certificaat niet geldig is?

Het aangepaste domein serveert de korte link voordat het certificaat bestaat, wat gebeurt wanneer het DNS-record is toegevoegd maar de verificatie nooit is voltooid, of wanneer het domein met een A-record naar de redirectservice is gewezen in plaats van de CNAME die de provider vroeg. Rond de verificatie af en het certificaat wordt automatisch uitgegeven.

Waarom werkt mijn korte link in een browser maar niet in WhatsApp of Slack?

Omdat de app het domein tegen een reputatielijst controleert voordat hij het bericht doorlaat, en gratis gedeelde shortenerdomeinen dragen welke reputatie hun slechtste gebruiker ook heeft verdiend. Diezelfde link naar je eigen domein verplaatsen lost het op, omdat de reputatie dan alleen van jou is.

Wat betekent een redirectlus bij een korte link?

De bestemming wijst uiteindelijk terug naar de korte link, waardoor de browser ertussen heen en weer stuitert totdat hij het opgeeft. Dit gebeurt meestal wanneer iemand een link bewerkt zodat die naar een pagina wijst die zelf weer doorstuurt naar de korte URL, of wanneer twee links naar elkaar wijzen. Stel de bestemming in op de uiteindelijke pagina.

Mijn korte link geeft een 404, maar ik zie hem wel in het dashboard. Wat nu?

Controleer de hoofdletters en de tekens: slugs zijn meestal hoofdlettergevoelig, dus /Spring en /spring zijn verschillende links, en een hoofdletter I naast een kleine letter l is makkelijk verkeerd over te typen vanaf een gedrukte tekst. Controleer daarna of de link een vervaldatum heeft of een geo-regel die de plek waar je test uitsluit.

Hoe lang zou het moeten duren voordat een korte link gaat werken?

Een link op een domein dat al live is, werkt meteen. Een gloednieuw aangepast domein wacht op DNS-propagatie en het uitgeven van het certificaat, wat meestal minuten duurt maar tot een uur kan oplopen, afhankelijk van de vorige TTL van het record dat je hebt gewijzigd.

Probeer Elido

Plak een URL, krijg een werkende korte link

Geen aanmelding nodig. Link blijft 30 dagen actief. Meld je aan om hem voor altijd te bewaren.

Gratis, geen aanmelding nodig · 2 per dag

Probeer Elido

In de EU gehoste URL-shortener met aangepaste domeinen, uitgebreide analyses en een open API. Gratis abonnement - geen creditcard nodig.

Tags
short link not working
short url 404
short link certificate error
redirect not working
short link blocked
troubleshoot short links

Verder lezen