API

Kurzlinks per API

Erstelle und verwalte Kurzlinks programmatisch – REST, JSON, API-Keys. Verfügbar ab dem Business-Plan.

Authentifizierung

Erstelle einen API-Key im Dashboard unter „API“ und sende ihn als Bearer-Token. Der Key wird nur einmal angezeigt und serverseitig ausschließlich als Hash gespeichert.

curl https://kurzuri.de/api/v1/me \
  -H "Authorization: Bearer kzr_DEIN_API_KEY"

Endpunkte

Basis-URL: https://kurzuri.de/api/v1

Methode	Pfad	Beschreibung
GET	/links	Links auflisten (Cursor-Pagination)
POST	/links	Link anlegen
GET	/links/{id}	Link abrufen
PATCH	/links/{id}	Link ändern (Teilupdate)
DELETE	/links/{id}	Link löschen
GET	/links/{id}/stats	Klick-Statistik
GET	/domains	Verifizierte eigene Domains
GET	/me	Konto, Plan & Verbräuche

Maschinenlesbare Spezifikation: /api/v1/openapi.json (OpenAPI 3.1)

Beispiel · Link anlegen

curl -X POST https://kurzuri.de/api/v1/links \
  -H "Authorization: Bearer kzr_DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "targetUrl": "https://example.com/sommer-kampagne",
    "slug": "sommer24",
    "title": "Sommer-Kampagne",
    "domain": "go.beispiel.de"
  }'

Antwort (201):

{
  "id": "42",
  "slug": "sommer24",
  "shortUrl": "https://go.beispiel.de/sommer24",
  "targetUrl": "https://example.com/sommer-kampagne",
  "title": "Sommer-Kampagne",
  "domain": "go.beispiel.de",
  "active": true,
  "clicks": 0,
  "createdAt": "2026-06-06T12:00:00.000Z"
}

Rate-Limits

120 Anfragen pro Minute und Key. Jede Antwort enthält RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset; bei Überschreitung kommt 429 mit Retry-After.

Fehler

Fehler folgen RFC 9457 (application/problem+json):

{
  "type": "https://kurzuri.de/api-docs#fehler",
  "title": "Validierung fehlgeschlagen",
  "status": 422,
  "detail": "targetUrl ist erforderlich."
}