Authentifizierung

Alle API-Requests brauchen einen gültigen API-Key im Authorization-Header.

API-Key erstellen

Gehe im Finseo Dashboard zu Settings > API
Klicke auf Create API Key
Wähle einen Namen, Scopes und optional eine Beschränkung auf bestimmte Projekte
Kopiere den Key sofort — er wird nur einmal angezeigt

Key verwenden

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.finseo.ai/v1/projects

import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(
    "https://api.finseo.ai/v1/projects",
    headers=headers
)

const response = await fetch("https://api.finseo.ai/v1/projects", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

Einen Key verifizieren

GET /v1/me gibt den Account zurück, zu dem ein Key gehört. Damit prüfst du, ob ein Key gültig ist, zeigst Nutzern den verbundenen Account an und liest die Scopes des Keys aus — der Endpoint antwortet unabhängig davon, ob der Account schon Projekte hat. Genau deshalb ist er der richtige Endpoint für Integrationen und Verbindungstests.

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.finseo.ai/v1/me

{
  "data": {
    "id": "6a81e088f8ef06e062c40633",
    "email": "you@example.com",
    "accountName": "Your Company",
    "tier": "Business",
    "projectCount": 1,
    "scopes": ["read", "write"],
    "environment": "live"
  }
}

Ein ungültiger oder widerrufener Key liefert 401 mit dem Fehlercode UNAUTHORIZED.

Scopes

API-Keys können einen oder mehrere Scopes haben:

Scope	Beschreibung
`read`	Daten lesen (Projekte, Prompts, Metriken, Wettbewerber, Quellen)
`write`	Daten ändern (Prompts erstellen, Tags aktualisieren, Projekte verwalten)
`export`	Tracking-Daten als Bulk-Export abrufen

Projekt-Beschränkungen

Du kannst einen Key optional auf bestimmte Projekte beschränken. Ein Key ohne Projekt-Beschränkung hat Zugriff auf alle Projekte deines Accounts.

Key-Sicherheit

Gib API-Keys niemals in Client-Code oder öffentlichen Repositories preis.

Keys werden vor der Speicherung mit SHA-256 gehasht — wir speichern niemals Klartext
Rotiere Keys regelmäßig und widerrufe kompromittierte Keys sofort
Nutze Test-Keys für die Entwicklung, Live-Keys für die Produktion

Übersicht

Erste Schritte

Analytics

API-Authentifizierung & API-Keys

Authentifizierung

API-Key erstellen

Key verwenden

Einen Key verifizieren

Scopes

Projekt-Beschränkungen

Key-Sicherheit

​Authentifizierung

​API-Key erstellen

​Key verwenden

​Einen Key verifizieren

​Scopes

​Projekt-Beschränkungen

​Key-Sicherheit

Authentifizierung

API-Key erstellen

Key verwenden

Einen Key verifizieren

Scopes

Projekt-Beschränkungen

Key-Sicherheit