Kurzlink-API - Dokumentation

JSON-API zum Erstellen und Abfragen von Kurzlinks. Verwenden Sie den für Ihr Konto ausgestellten API-Schlüssel (oder ggf. den Plattform-API_TOKEN).

Öffentliche API: https://anyurl.bond - JSON unter /api/v1/.

Authorization

Authorization: Bearer 1234

Senden Sie den exakten API-Schlüssel als Authorization: Bearer. Die Dashboard-Anmeldung nutzt denselben Schlüssel mit Ihrer E-Mail.

POST /api/v1/shorten

{"long_url":"https://example.com","expiration_time":"24h","max_uses":100,"allow_bots":false}

{"long_url":"https://example.com","permanent":true}

Optionale Felder expiration_time und max_uses gelten für den bezahlten Tarif. Ohne Zahlung gelten ein monatliches Kalenderlimit (UTC, Reset am 1.) und jeder Link läuft nach ca. 10 Minuten ab, unabhängig vom Request-Body.

GET /api/v1/info/{short_code}

Liefert Metadaten und Gültigkeit eines Kurzcodes, ohne Klickzähler zu erhöhen.

GET /api/v1/me

Liefert Ihren Tarif, effektive Limits aus dem Panel und die Nutzung des laufenden Monats (UTC): neue Links und API-Änderungen.

GET /api/v1/links

?limit=50&offset=0

Listet nur Kurzlinks, die mit Ihrem Konto-API-Schlüssel erstellt wurden (owner_id entspricht diesem Schlüssel; gleicher Umfang wie GET /info). Der Plattform-API-Token kann diesen Endpunkt nicht nutzen. Optionale Parameter: limit (Standard 50, max. 100), offset (Standard 0, max. 100000). JSON: links (gleiche Felder wie GET /info pro Eintrag), total, limit, offset. Das Listing löscht keine Zeilen und erhöht keine Klicks.

PUT / PATCH /api/v1/info/{short_code}

{"long_url":"https://example.com/new","expiration_time":"24h","max_uses":20,"allow_bots":false}

Zum Ändern eines vorhandenen Kurzcods PUT oder PATCH auf /api/v1/info/{short_code} verwenden - nicht POST /shorten. JSON-Body: beliebig aus long_url, expiration_time, max_uses, allow_bots. Feld weglassen, um es unverändert zu lassen. Zeitablauf mit expiration_time "" entfernen; unbegrenzte Nutzungen mit max_uses -1. Antwort wie bei GET /info.

Kommandozeilenbeispiele (curl)

Der Token 1234 ist nur ein Beispiel - verwenden Sie Ihren echten API-Schlüssel. Host: https://anyurl.bond.

POST /api/v1/shorten - volles JSON (Host https://anyurl.bond)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"expiration_time\":\"24h\",\"max_uses\":100,\"allow_bots\":false}"

POST /api/v1/shorten - minimale Anfrage (bezahlt: Standardablauf 24 h)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

POST /api/v1/shorten - dauerhaft (bezahlt; zählt als Smart-Edit)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"permanent\":true}"

GET /api/v1/info/{short_code} - Beispiel-Kurzcode abc123

curl -sS 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234'

GET /api/v1/me

curl -sS 'https://anyurl.bond/api/v1/me' \
  -H 'Authorization: Bearer 1234'

GET /api/v1/links - Ihre Kurzlinks seitenweise abrufen

curl -sS 'https://anyurl.bond/api/v1/links?limit=50&offset=0' \
  -H 'Authorization: Bearer 1234'

PATCH /api/v1/info/{short_code}

curl -sS -X PATCH 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated-destination\"}"

PUT /api/v1/info/{short_code}

curl -sS -X PUT 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated\",\"expiration_time\":\"7d\",\"max_uses\":50,\"allow_bots\":true}"

Verbose (-v) zur Fehlersuche

curl -v -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

Kostenlose API-Stufe: bis zu 100 neue Kurzlinks pro Kalendermonat (UTC); das Kontingent wird am 1. des Monats zurückgesetzt. Jeder Link erlischt nach etwa 10 Minuten. Bezahlte Tarife folgen demselben Monatsrhythmus.

Zur Startseite · AGB