Authentifizierung

Authentifizierung

Alle FlowCaptain-API-Anfragen erfordern eine Authentifizierung über einen Bearer-Token im Authorization-Header.

API-Schlüssel-Authentifizierung

Authorization: Bearer sk_live_ihr_api_schluessel

API-Schlüssel sind einem bestimmten Kalender zugeordnet. Jede Anfrage, die mit einem Schlüssel authentifiziert wird, arbeitet mit der Konfiguration, den Öffnungszeiten und dem Google Kalender dieses Kalenders.

Anfrage-Beispiel

curl -X POST https://api.flowcaptain.ai/api/v1/check-availability \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_live_ihr_api_schluessel" \
  -d '{"query": "nächsten Montag"}'

Fehlerantworten

Fehlender oder ungültiger API-Schlüssel:

{
  "error": "Unauthorized",
  "message": "Invalid or missing API key"
}

HTTP-Status: 401 Unauthorized

Schlüssel gehört zu einem deaktivierten Kalender:

{
  "error": "Forbidden",
  "message": "This calendar is not active"
}

HTTP-Status: 403 Forbidden

MCP-Authentifizierung

Der MCP-Endpunkt (POST /mcp) verwendet dieselbe Bearer-Token-Authentifizierung:

Authorization: Bearer sk_live_ihr_api_schluessel

Der Accept-Header muss application/json, text/event-stream für MCP-Anfragen enthalten.