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
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" } }Dokumentation
Alle Kapitel
01Getting StartedErster Call in Minuten.↗02AuthentifizierungBearer-Token & Scopes.↗03Produkte & EndpointsVerkaufbares abrechenbar machen.↗04KundenAnlegen, verwalten, abrechnen.↗05BillingPläne, Abos, Rechnungen.↗06WebhooksSignierte Events empfangen.↗07Errors & PaginationKonventionen der API.↗08API-Referenz (Scalar)Alle Endpoints & Schemas.↗09MCP-ServerMit deinem Agent bauen (OAuth).→
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 →