Start · Provider-Docs
Provider-Docs

Provider-Docs

Integriere Florentin in dein Backend — per REST, SDK oder MCP. Eine REST-API pro Domain, Bearer-Token, JSON als { data, meta }.

Eine API, an deine Domain gebunden

Die Provider-API ist die Server-Seite von Florentin: Damit legst du Kunden an, definierst Produkte und Pläne, verbuchst Verbrauch, gibst Keys aus und reagierst auf Events. Sie ist als eine REST-API je Provider-Domain organisiert und über einen Bearer-Token authentifiziert, der an genau diese Domain gebunden ist.

Erfolgreiche Antworten kommen als { data, meta }, Fehler als { error } mit passendem HTTP-Status. Alternativ baust du mit deinem Coding-Agent über den MCP, ohne die Endpunkte einzeln zu lernen.

Grundlagen

Wie die Provider-API funktioniert

Base-URLhttps://<provider-subdomain>.florentin.ai/api/v1
AuthAuthorization: Bearer 42|<secret>
FormatJSON, Antworten als { data, meta }.
MCPOAuth über /api/mcp — mit deinem Agent bauen.
Beispiel

Einen Kunden anlegen

florentin · customers
curl -X POST https://acme.florentin.ai/api/v1/customers \
  -H "Authorization: Bearer 42|kP3f9c…" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Ada Lovelace", "email": "team@kunde.io" }'
← 201  { "data": { "id": "7b9c3e2a-…", "email": "team@kunde.io" },
         "meta": { "message": "Customer created successfully" } }
FAQ

Häufig gefragt

Wie ist die Base-URL aufgebaut?
Pro Provider-Domain: https://<provider-subdomain>.florentin.ai/api/v1 — oder deine eigene Custom Domain.
Welche Sprachen werden unterstützt?
Generierte Clients für cURL, TypeScript und Python liegen in der Scalar-Referenz.

Bau dein Produkt. Den Rest übernehmen wir.

Konten, Abrechnung, Credits, Portal, Zugriff — integriert. Stripe voll dabei.

Kostenlos starten