Schnittstelle

Für Programme, die lange Links brauchen. Keine Anmeldung, kein Schlüssel, ein Endpunkt.

Anfrage

POST https://superlangerlink.de/api/verlaengern
Content-Type: application/json

{
  "url": "https://example.com/irgendwas",
  "laenge": 2000,
  "geschmack": "komposita"
}

Antwort

201 Created

{
  "url": "https://superlangerlink.de/…",
  "laenge": 2000,
  "geschmack": "komposita",
  "ziel": "https://example.com/irgendwas",
  "kennung": "Ab3dEf4gH5jK",
  "urkunde": "https://superlangerlink.de/urkunde/Ab3dEf4gH5jK"
}

Felder

url

Ziel. Pflicht. Nur http und https. Fehlt das Schema, nehmen wir https.

laenge

Gesamtlänge der fertigen URL in Zeichen. 100 bis 32.000.

geschmack

Füllmaterial: zufall, komposita, buerokratie, enterprise, lorem. Ohne Angabe: zufall.

Besondere Vorkommnisse

hinweis

Erscheint, wenn das Ziel ein Kurzlink war (bit.ly, t.co und Verwandte). Der Link wird dann zehn Prozent länger als bestellt, als Ausgleich. laenge in der Antwort ist die tatsächliche Länge.

rekursionsstufe

Erscheint, wenn das Ziel selbst ein superlangerlink ist. 2 für einen Link auf einen Link, 3 für einen Link darauf, und so weiter. Ab 5 verweisen wir auf die Hotline.

urkunde

Öffentliche Seite, die die Länge bescheinigt. Ohne Ziel, ohne Link, druckbar.

Fehler

Status 400 mit {"fehler": "…"} bei ungültiger Eingabe, 429 bei zu vielen Anfragen. Nicht Zutreffendes bitte streichen.