Zum Inhalt springen

API und Webhooks

Aktualisiert:

API-Schlüssel mit Laufzeit und IP-Liste, Webhooks und der BI-Feed unter Einstellungen → Integrationen & API.

Einstellungen in Fiatto öffnen
In 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

  1. Öffnen Sie Einstellungen (Kontomenü) → Karte Integrationen & API.
  2. 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.
  3. 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 verpflichtenden Idempotency-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 Scope bi.read und funktioniert nur auf dem read-only OData-Feed.
  4. 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, etwa contract.created, contract.status_changed, contract.renewed und contract.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.json und in den Deprecation-/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 Umgebung live), 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.
War dieser Artikel hilfreich?
Alle Artikel zu diesem Thema ansehen

Eine andere Antwort finden

Eine Aufgabe, Funktion oder kurze Frage genügt.