Für Entwickler

API

Kurzlinks direkt aus deiner App, deinem Skript oder deinem CMS erstellen – ohne Anmeldung und ohne API-Schlüssel.

Endpunkt

POST https://firsturl.de/api/v1/shorten
Content-Type: application/json

Parameter

Feld	Typ	Beschreibung
`url`	string	Ziel-URL (Pflicht). Ohne Schema wird https:// ergänzt.
`wait`	int 0–12	Wartezeit der Zwischenseite in Sekunden. Standard: 3.
`alias`	string	Optionaler Wunsch-Alias (3–40 Zeichen: A–Z, a–z, 0–9, - und _).
`expires_in_days`	int	Optionale Gültigkeit in Tagen: 1, 7, 30, 90, 365. Ohne Angabe unbegrenzt.

Beispiel

curl -X POST https://firsturl.de/api/v1/shorten \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/ein/sehr/langer/link", "wait": 0}'

Antwort

HTTP/1.1 201 Created
{
  "code": "aB3xY7k",
  "short_url": "https://firsturl.de/aB3xY7k",
  "preview_url": "https://firsturl.de/aB3xY7k+",
  "manage_url": "https://firsturl.de/m/…",
  "target": "https://example.com/ein/sehr/langer/link",
  "wait": 0,
  "expires_at": null
}

Fehler & Limits

Fehler werden mit passendem HTTP-Status (400, 422, 429) und einem JSON-Objekt mit "error" und "message" beantwortet. Pro IP-Adresse sind 30 neue Links pro Stunde möglich.

HTTP/1.1 422 Unprocessable Entity
{ "error": "url_invalid", "message": "…" }