Authentifizierung

Jede Anfrage an die Crisphive-API wird mit einem geheimen API-Schlüssel authentifiziert, der als Bearer-Token im Authorization-Header gesendet wird. Erstellen Sie Schlüssel im Dashboard unter Settings → Developers — der Schlüsselwert wird nur einmal bei der Erstellung angezeigt, kopieren Sie ihn also sofort.

curl "https://api.crisphive.com/v1/customers" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT"

Schlüsselpräfixe wählen die Umgebung

Das Schlüsselpräfix bestimmt die Datenumgebung: chsk_live_-Schlüssel lesen und schreiben Produktionsdaten (live), chsk_test_-Schlüssel zielen auf die isolierte Sandbox. API-Schlüssel laufen ab: Sie wählen die Laufzeit bei der Erstellung — standardmäßig 30 Tage, von 1 bis 365 — und sie steht für die gesamte Lebensdauer des Schlüssels fest; expires_at verschiebt sich nie. Zum Erneuern erstellen Sie einen Ersatzschlüssel und widerrufen den alten — siehe Authentifizierung.

Scopes

Ein Schlüssel hat entweder Vollzugriff oder ist auf bestimmte Berechtigungs-Scopes beschränkt (z. B. Job-Requests erstellen ohne Lesezugriff auf Ihre Kundenliste) und ist immer an einen Workspace und eine Umgebung (live oder Sandbox) gebunden.