API und Webhooks
Aktualisiert:
API-Schlüssel mit Laufzeit und IP-Liste, Webhooks und der BI-Feed unter Einstellungen → Integrationen & API.
Einstellungen in Fiatto öffnenIn diesem Artikel
Neben SSO/SCIM und der Buchhaltungsanbindung bietet Fiatto eine REST-API, Webhooks und einen BI-Feed. Administratoren verwalten sie unter Einstellungen → Integrationen & API (/dashboard/settings/integraties).
Schritte
- Öffnen Sie Einstellungen (Kontomenü) → Karte Integrationen & API.
- Erstellen Sie unter API-Schlüssel einen Schlüssel: Name eingeben, Laufzeit wählen (30, 90 oder 180 Tage oder 1 Jahr) und optional Erlaubte IP-Adressen eintragen (eine Adresse oder ein CIDR-Bereich pro Zeile). Klicken Sie Schlüssel erstellen und kopieren Sie den Schlüssel sofort: Sie sehen ihn nur einmal. In der Sandbox trägt der Schlüssel
_test_im Namen und funktioniert nur auf der Übungsumgebung. - Halten Sie die Rechte eng. Ein API-Schlüssel (Scope
api) arbeitet auf/api/v1: Einkaufsanfragen, Einkaufsrechnungen, Verträge, Lieferanten und Programme lesen und schreiben; Kunden und Verkaufsaufträge lesen und anlegen; Legal Tickets lesen und einreichen; Verkaufsrechnungen und -verträge, Bestellungen, Wareneingänge und Zahlungen nur lesen. Ein Verkaufsauftrag über die API kommt als Entwurf an, mit denselben Prüfungen wie auf dem Bildschirm (etwa dem Kreditlimit) und einem verpflichtendenIdempotency-Key. Die festen Übergaben zwischen Modulen lesen Sie als Feed unter/api/v1/handovers. Das Hauptbuch (Buchungen und Saldenliste) und das Prüfprotokoll für ein SIEM schalten Sie pro Schlüssel separat frei; Hauptbuchzugang vergibt nur ein Freigebender oder Buchhalter. Ein Schlüssel aus BI-Connector (Power BI / Excel) hat den Scopebi.readund funktioniert nur auf dem read-only OData-Feed. - Fügen Sie unter Webhooks einen Endpunkt hinzu, wählen Sie die Events und senden Sie ein Test-Event; fehlgeschlagene Zustellungen sehen Sie im Zustellprotokoll. Geheimnis rotieren erzeugt ein neues Signing-Secret; das alte bleibt noch 24 Stunden gültig. Pro Endpunkt wählen Sie das Nachrichtenformat: Fiatto (Standard) oder CloudEvents 1.0 (der offene Standard; eine Übergabe kommt dann genau so an wie im Feed). In der Event-Liste stehen auch die Übergaben (
handover.*) und der Lebenszyklus von Verträgen, etwacontract.created,contract.status_changed,contract.renewedundcontract.expired.
Tipps
- Verwenden Sie API-Schlüssel nie in einem Browser oder einer mobilen App. Verlängern geht nicht: Erstellen Sie einen neuen Schlüssel, tragen Sie ihn in Ihre Anbindung ein und widerrufen Sie den alten. Administratoren und der Ersteller erhalten 14 und 3 Tage vorher eine Erinnerung; ein Schlüssel, der 90 Tage nicht genutzt wurde, wird nach einer Warnung automatisch widerrufen. Eine IP-Liste können Sie nachträglich nur verkleinern (IP-Liste einschränken). Bei jedem API-, BI- und Assistentenschlüssel sehen Sie, wann und von welcher Adresse er zuletzt verwendet wurde; hat er noch keine IP-Liste, beschränken Sie ihn mit Auf diese Adresse beschränken mit einem Klick auf diese Adresse.
- Jeder Schlüssel hat standardmäßig ein Limit von 120 Anfragen pro Minute; lesen Sie die
X-RateLimit-*-Header, um vor einem 429 abzubremsen. Die Versionsrichtlinie steht in/api/v1/openapi.jsonund in denDeprecation-/Sunset-Headern: eine Version wird mindestens 12 Monate im Voraus angekündigt. - Ein SIEM kann einen Webhook-Endpunkt für das Event der Sicherheitsereignisse abonnieren (Anmeldungen, Zwei-Schritt-Verifizierung, Rollen- und Richtlinienänderungen, Notfallknopf, Support-Zugang).
- In der Sandbox ist jeder Webhook-Endpunkt ein Testendpunkt: Jede Zustellung trägt den Header
X-Fiatto-Environment: test(in Ihrer echten Umgebunglive), und API-Schlüssel und Test-Webhooks bleiben erhalten, wenn Sie die Sandbox leeren. Siehe Üben in der Sandbox. - Alle Integrationen mit Status, Apps von Drittanbietern und das Developer-Portal finden Sie unter Einstellungen → Integrationen & Apps (Marktplatz) (
/dashboard/settings/koppelingen). Claude oder ChatGPT verbinden: externe KI-Assistenten. Daten ohne API mitnehmen: Datenexport.