POST AI agent ready /v1/short-url/create

URL-Shortener-API – Erstellen Sie kurze Links mit Klick-Tracking

Senden Sie eine URL und erhalten Sie einen verkürzten Link mit einem automatisch generierten oder benutzerdefinierten Slug. Kurze Links leiten über 302 weiter und verfolgen die Klickzahlen. Benutzerdefinierte Slugs unterstützen Buchstaben, Zahlen, Bindestriche und Unterstriche. Wenn ein Slug bereits vergeben ist, gibt die API einen Fehler zurück, sodass Sie es mit einem anderen erneut versuchen können.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/short-url/create \
  -H "Content-Type: application/json" \
  -d '{"url":"https://docs.botoi.com/getting-started","custom_slug":"getting-started"}'

When to use this API

Generieren Sie nachverfolgbare Kurzlinks für Marketingkampagnen

Erstellen Sie für jede Kampagne einen benutzerdefinierten Slug-Kurzlink (z. B. /launch-2026). Verwenden Sie den Statistikendpunkt, um Klicks zu verfolgen und das Engagement ohne externe Analysetools zu messen.

Integrieren Sie eine Link-Shortener-Funktion in Ihr SaaS-Produkt

Ermöglichen Sie Ihren Benutzern, innerhalb Ihrer App markenbezogene Kurzlinks zu erstellen. Die API übernimmt die Slug-Generierung, Kollisionserkennung und Weiterleitungsverfolgung, sodass Sie diese Infrastruktur nicht aufbauen müssen.

Frequently asked questions

Laufen Kurzlinks ab?

Über die API erstellte Kurzlinks haben kein integriertes Ablaufdatum. Sie verbleiben im Speicher, bis sie manuell entfernt oder der zugrunde liegende Speicher gelöscht wird.

Was passiert, wenn mein benutzerdefinierter Slug bereits vergeben ist?

Die API gibt einen SLUG_TAKEN-Fehler zurück. Sie können es mit einem anderen Slug erneut versuchen oder das Feld „custom_slug“ weglassen, um einen automatisch generierten Slug mit 6 Zeichen zu erhalten.

Welche Zeichen sind in benutzerdefinierten Slugs zulässig?

Buchstaben (A-Z, a-z), Zahlen (0-9), Bindestriche (-) und Unterstriche (_). Alle anderen Zeichen verursachen einen INVALID_SLUG-Fehler.

Werden die Klickzahlen automatisch erfasst?

Ja. Jedes Mal, wenn jemand die Kurz-URL besucht, erhöht sich der Klickzähler. Verwenden Sie den Endpunkt /v1/short-url/stats, um die aktuelle Anzahl abzurufen.

Welche Art von Weiterleitung verwendet die Kurz-URL?

Die Kurz-URL gibt eine 302-Weiterleitung (temporär) zurück. Dies bedeutet, dass Suchmaschinen kein Link-Equity auf die Ziel-URL übertragen und Sie das Ziel später bei Bedarf ändern können.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.