kortste.link

API

Een JSON-API zonder sleutel en zonder registratie.

Basis

Alle endpoints staan op api.kortste.link. Je hebt geen sleutel nodig.

Een link inkorten

curl -X POST https://api.kortste.link/v1/links \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://seznam.cz/m/sem/1345"}'
{
  "code": "fp9qm3",
  "shortUrl": "https://kortste.link/fp9qm3",
  "url": "https://seznam.cz/m/sem/1345",
  "createdAt": "2026-08-22T18:49:11.665Z"
}

Een link opvragen

curl https://api.kortste.link/v1/links/fp9qm3

Geeft 200 met dezelfde velden, 404 als de code niet bestaat, of 410 als de link is verwijderd.

De doorverwijzing

curl -i https://kortste.link/fp9qm3

Geeft 302 met de bestemming in de Location-header. Bewust 302 en niet 301: een permanente doorverwijzing wordt door browsers vrijwel voorgoed onthouden, waardoor een link nooit meer teruggehaald kan worden.

Misbruik melden

curl -X POST https://api.kortste.link/v1/abuse \
  -H 'Content-Type: application/json' \
  -d '{"code":"fp9qm3","reason":"phishing"}'

Foutmeldingen

Fouten volgen RFC 9457 en komen terug als application/problem+json met de velden type, title, status en detail.

400
De body is geen geldige JSON.
422
De link kan niet worden ingekort. Het detail-veld zegt waarom.
429
Te veel verzoeken. De Retry-After-header zegt hoe lang je moet wachten.
503
Er kon geen code worden uitgegeven.

Grenzen

Tien aanmaakverzoeken per minuut en tweehonderd per dag per client. Doorverwijzingen worden nooit begrensd.