Schnellstart

Mit der Beklio Link Developer API verwalten Sie Ihre Link-Ressourcen mit echten (Live-)Daten. Alle öffentlichen Anfragen laufen über das Gateway unter https://api.beklio.com/api/v1/links.

1. Schlüssel erstellen#

Melden Sie sich in der Entwicklerkonsole an und erstellen Sie einen bk_live_…-Schlüssel mit nur den Scopes, die Sie benötigen. Das Secret wird nur einmal in der Antwort auf die Erstellung angezeigt; speichern Sie es sofort in einem Secret Manager.

2. Erste Anfrage senden#

curl -X POST "https://api.beklio.com/api/v1/links" \
  -H "Authorization: Bearer bk_live_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-2026-001" \
  -d '{
    "kind": "DIRECT",
    "domainId": "bekl.io",
    "url": "https://example.com/launch",
    "slug": "launch"
  }'

Das Gateway normalisiert Antworten in einen { data, meta? }-Umschlag, und jede Antwort enthält einen X-Request-Id-Header.

3. Nächste Schritte#

• Authentifizierung und Scopes — welche Aktion welche Berechtigung erfordert.
• Links erstellen — der Unterschied zwischen Kurzform und vollständigem Route-Graph.
• Fehler und Limits — das Verhalten bei 401/403/409/429/503.