Zum Inhalt springen

Link Developer API · v1

Binden Sie echte Link-Daten in Ihr Produkt ein.

Live-Schlüssel mit Scopes, Targeting per Route-Graph, QR und Analytics. Die Referenz ist öffentlich; Schlüssel, Nutzung und Tester finden Sie in der Konsole nach der Anmeldung.

Schlüssel erstellen Schnellstart

Nur Schlüssel vom Typ bk_live_* · die Eigentümerschaft kommt vom Schlüssel

terminalGET
$ curl api.beklio.com/api/v1/links?limit=2 \  -H "Authorization: Bearer bk_live_…"HTTP/1.1 200 OK · x-request-id: req_…{  "data": [    { "id": "lnk_…", "slug": "launch", "kind": "DIRECT" },    { "id": "lnk_…", "slug": "docs", "kind": "DIRECT" }  ],  "meta": { "requestId": "req_…" }}$

Einstieg

In drei Schritten live.

Vom Erstellen eines Schlüssels bis zur Produktion; jeder Schritt verweist auf die passende Anleitung.

  1. 01

    Schlüssel erstellen

    Erzeugen Sie in der Konsole einen bk_live_-Schlüssel mit nur den benötigten Scopes.

    Konsole öffnen
  2. 02

    Erste Anfrage senden

    Erstellen Sie Ihren ersten Link mit dem Authorization-Header und einem Idempotency-Key.

    Schnellstart
  3. 03

    In Produktion gehen

    Behandeln Sie Fehlercodes, Kontingente und das Wiederholungsverhalten.

    Fehler und Limits

Ressourcen

Alles, was Sie brauchen.

Dokumentation10 Anleitungen: von der Authentifizierung bis zur Fehlerbehandlung.
  • Schnellstart
  • Authentifizierung und Scopes
  • OAuth 2.0 und PKCE
  • Links erstellen und verwalten
API-Referenz45 Endpunkte mit Methode, Pfad und erforderlichem Scope.
  • GET/api/v1/links
  • POST/api/v1/links
  • GET/api/v1/links/:id
  • PATCH/api/v1/links/:id
EntwicklerkonsoleSchlüssel, Tarifnutzung und ein Live-API-Tester.
Productionbk_live_•••••••• Aktiv
ToolsLaden Sie das OpenAPI-Schema und die Postman-Collection herunter und testen Sie Anfragen mit dem API-Tester.beklio-link-openapi.jsonPostman-Collection

Autorisierung

Standardmäßig minimale Rechte.

Jeder Schlüssel funktioniert nur mit den von Ihnen gewählten Scopes; Anfragen mit fehlendem Scope werden mit 403 abgelehnt.

Authentifizierungsanleitung
  • links:readLesen von Links, Trees, Boards, Ordnern, Routes und QR.
  • links:writeErstellen, Aktualisieren, Route-Unterressourcen und Schreiben von QR.
  • links:deleteLöschen von Links und Unterressourcen.
  • analytics:readAnalytics-Daten Ihrer eigenen Links.
  • domains:readLesen von Domain-Metadaten.