URL-Verkürzer-API: URLW in Ihre Anwendungen integrieren

Die URLW REST-API ermöglicht es Ihnen, die Erstellung, Verwaltung und Analyse von Kurzlinks direkt in Ihre Anwendungen, Skripte oder automatisierten Workflows zu integrieren. Ob Sie ein CRM, eine E-Mail-Marketing-Plattform oder ein internes Tool erstellen – die URLW-API lässt sich mit wenigen Codezeilen integrieren.

Authentifizierung per API-Schlüssel

Alle Anfragen an die URLW-API müssen über einen API-Schlüssel authentifiziert werden, der im Authorization-Header übermittelt wird. So erhalten Sie Ihren Schlüssel:

1. Melden Sie sich bei Ihrem URLW-Konto an
2. Gehen Sie zu Einstellungen → API
3. Klicken Sie auf „Neuen API-Schlüssel generieren"
4. Kopieren und bewahren Sie diesen Schlüssel sicher auf – er wird nur einmal angezeigt

Übermitteln Sie Ihren Schlüssel in jeder Anfrage über den HTTP-Header:

Authorization: Bearer IHR_API_SCHLUESSEL

Geben Sie Ihren API-Schlüssel niemals in clientseitigem Code preis (Frontend-JavaScript, mobile Anwendungen). Verwenden Sie immer ein intermediäres Backend für API-Aufrufe.

Erste Schritte: Eine URL mit curl kürzen

So erstellen Sie Ihren ersten Kurzlink über die URLW-API mit dem curl-Befehl:

curl -X POST https://urlw.fr/api/v1/links \
-H "Authorization: Bearer IHR_API_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{
"url": "https://beispiel.de/meine-sehr-lange-ziel-url",
"slug": "mein-link",
"domain": "go.ihre-marke.de"
}'

Antwort bei Erfolg (HTTP 201):

{
"id": "lnk_abc123",
"short_url": "https://go.ihre-marke.de/mein-link",
"original_url": "https://beispiel.de/meine-sehr-lange-ziel-url",
"slug": "mein-link",
"clicks": 0,
"created_at": "2025-06-01T10:00:00Z"
}

Wichtigste Endpoints der URLW-API

Die URLW-API stellt folgende REST-Endpoints bereit:

• POST /api/v1/links — Neuen Kurzlink erstellen
• GET /api/v1/links — Ihre Links auflisten (mit Paginierung)
• GET /api/v1/links/{id} — Link anhand seiner ID abrufen
• PATCH /api/v1/links/{id} — Bestehenden Link ändern (Ziel-URL, Slug, Ablauf)
• DELETE /api/v1/links/{id} — Link löschen
• GET /api/v1/links/{id}/stats — Klickstatistiken eines Links abrufen
• POST /api/v1/links/batch — Mehrere Links in einer einzigen Anfrage erstellen

Die vollständige Dokumentation mit Parametern, Antwortcodes und Beispielen für jeden Endpoint ist verfügbar unter /de/docs.

Rate Limits und Best Practices

Um die Servicequalität für alle Nutzer zu gewährleisten, wendet die URLW-API Rate Limits je nach Ihrem Plan an:

• Starter-Plan: 60 Anfragen pro Minute
• Pro-Plan: 300 Anfragen pro Minute
• Business-Plan: 1 000 Anfragen pro Minute

Wenn Sie das Limit überschreiten, gibt die API eine HTTP-Antwort 429 Too Many Requests mit einem Retry-After-Header zurück, der die Wartezeit angibt. Implementieren Sie einen Retry-Mechanismus mit exponentiellem Backoff in Ihren Anwendungen.

Best Practices für eine robuste Integration:

• Verwenden Sie den Batch-Endpoint, um mehrere Links in einer einzigen Anfrage zu erstellen, statt viele Einzelaufrufe zu tätigen
• Cachen Sie API-Antworten auf der Anwendungsseite, um unnötige Anfragen bei jeder Anzeige zu vermeiden
• Behandeln Sie HTTP-Fehlercodes (400, 401, 404, 422, 429, 500) systematisch in Ihrem Code
• Verwenden Sie URLW-Webhooks, um Benachrichtigungen über Ereignisse (Klick, Ablauf) zu erhalten, statt die API zu pollen

Um die API zu nutzen, erstellen Sie Ihr URLW-Konto und lesen Sie die vollständige API-Dokumentation.