Schnittstelle: eigene API-Schlüssel und Webhooks

Unter *Betrieb → Schnittstelle* legen Sie einen API-Schlüssel an — er wird einmal im Klartext angezeigt, danach ist nur noch sein Hash gespeichert. Verloren heißt: neuen anlegen, alten widerrufen.

Rechte

Jeder Schlüssel trägt entweder Lesen oder Schreiben, nie beides automatisch — für die eigene Auswertung reicht meist Lesen.

Was die API kann

Vier Bereiche: Anfragen, Kunden, Aufträge, Belege — jeweils nach demselben Muster.

Webhooks

Statt selbst abzufragen, lassen sich fünf Ereignisse zugestellt bekommen: neue Anfrage, Angebot angenommen, Angebot abgelehnt, Rechnung bezahlt, Termin verschoben. Jede Zustellung trägt eine Signatur im Kopf (`X-Livo-Signatur`), damit Sie prüfen können, dass sie wirklich von Livo kommt.

Zustellversuche

Schlägt eine Zustellung fehl, versucht Livo es bis zu sechsmal erneut. Danach gilt der Versuch als aufgegeben und wird als solcher markiert — nicht stillschweigend fallengelassen.

🔴 Grenze

Kein GraphQL, keine Bulk-Exporte über die API — für den kompletten Datenexport gibt es den JSON-Export unter *Team → Daten und Konto*.