Authentifizierung

API-Key im Portal erzeugen und mit jedem Request senden.

API-Key erzeugen

  1. Melden Sie sich im Partner-Portal an.
  2. Öffnen Sie Einstellungen → Integrationen.
  3. Erzeugen Sie einen BlinkOS API-Key.
  4. Kopieren Sie den Key sofort. Er wird nicht erneut angezeigt.
  5. Optional: hinterlegen Sie eine Webhook-URL. Beim ersten Speichern erzeugt BlinkOS ein Webhook-Secret für die HMAC-Signatur.

Ein Partner hat genau einen aktiven Key. Erneuern widerruft den bisherigen Key sofort. MCP-Tokens (Ability mcp) gelten nicht für diese API.

Die Webhook-URL und das Secret nutzen Sie unter Webhooks.

Authentication

Senden Sie den Key mit jedem Request:

Authorization: Bearer {token}
Accept: application/json

Alternativ:

X-API-KEY: {token}
Accept: application/json
Situation Status
Header fehlt oder Token unbekannt 401
Token ohne Ability api (z. B. MCP) oder inaktiver Benutzer 403

Der Token-User ist der Lead-Owner. Ein partner_id im Request ist nicht erlaubt.

Beispielantworten stehen unter Fehler.