Start · Auth, Errors & Idempotency
Konventionen
Auth, Errors & Idempotency
Die Konventionen, die für die ganze Florentin-API gelten — einmal verstanden, gelten sie überall.
Einmal lernen, überall anwenden
Die Florentin-API ist bewusst gleichförmig: Authentifizierung, Antwortform, Fehlerformat und Wiederholbarkeit funktionieren über alle Endpunkte gleich. Das macht die Integration vorhersehbar und reduziert Fehler — egal, ob du Kunden anlegst, Verbrauch verbuchst oder Webhooks verwaltest.
Im Überblick
✓
AuthBearer 42|<secret>, an die Provider-Domain gebunden.
✓
Base/api/v1, eine REST-API pro Domain.
✓
Antwort{ data, meta } bei Erfolg.
✓
Fehler{ error: { message, … } } mit HTTP-Status.
✓
Idempotencyidempotency_key bei Billing-Mutationen.
✓
Deduperequest_id bei /credits/consume.
Fehlerformat
← 422 Unprocessable Entity
{ "error": { "message": "email is required" } }
← 401 Unauthorized
{ "error": { "message": "invalid or missing bearer token" } }FAQ
Häufig gefragt
Wie sind Tokens aufgebaut?
Als <id>|<secret>, z. B. 42|kP3f9c… — serverseitig gehasht gespeichert.
Wofür ist die Idempotency?
Damit eine wiederholte Billing-Mutation nicht doppelt wirkt; bei /credits/consume dient request_id demselben Zweck.
Bau dein Produkt. Den Rest übernehmen wir.
Konten, Abrechnung, Credits, Portal, Zugriff — integriert. Stripe voll dabei.
Kostenlos starten →