Webhooks und API-Schlüssel
Fremdsysteme per Webhook über Ereignisse informieren und mit API-Schlüsseln mit minimalen Rechten anbinden.
Auf dieser Seite
Webhook anlegen
- Einstellungen → „Webhooks“ → „Neuer Webhook“ (Rolle Administrator/Inhaber).
- „Endpunkt-URL“ eintragen – im Produktivbetrieb nur
https://. - „Ereignisse“ wählen: „Alle Ereignisse (*)“, Gruppen wie
order.*,tour.*,stop.*,document.*,invoice.*,thread.*,customs.*,proposal.*,assignment.*oder eigene Muster (kommagetrennt, max. 50). - Schalter „Aktiv“ setzen und speichern.
Hinweis: Das „Signatur-Secret“ (whsec_…) wird genau einmal angezeigt – sichern Sie es sofort. „Secret rotieren“ erzeugt ein neues; das alte ist sofort ungültig.
Zustellung und Test
- Jede Zustellung ist ein
POSTmit JSON{ id, type, tenantId, occurredAt, payload }und den HeadernX-LogCon-Signature(HMAC-SHA256 über den rohen Body),X-LogCon-Event,X-LogCon-Delivery(Idempotenzschlüssel) undX-LogCon-Timestamp. - Ihr Endpunkt muss innerhalb von 10 s mit 2xx antworten; sonst folgen 5 Wiederholungen mit steigendem Abstand (10/20/40/… s).
- „Testereignis senden“ liefert sofort ein
webhook.ping. „Zustellungen“ zeigt die letzten 50 Versuche mit Zeit, Ereignis, Versuch, Status, Dauer und Fehler.
API-Schlüssel erstellen
Verwendung: Header x-api-key: lc_…. Ein Schlüssel handelt als Administrator, begrenzt durch seine Scopes. „Widerrufen“ sperrt ihn sofort. Plattform-Admin-Funktionen sind mit API-Schlüsseln nie erreichbar.
- Einstellungen → „API-Schlüssel“ → „API-Schlüssel erstellen“ (Rolle Administrator/Inhaber).
- „Name“ und „Berechtigungen“ (Scopes, kommagetrennt) eingeben.
- Den Schlüssel
lc_…sofort kopieren – er wird nur einmal angezeigt, danach nur noch das Präfix.
Scopes
| Scope | Bedeutung |
|---|---|
* oder leer | Vollzugriff auf den Mandanten |
<resource>:* | alles auf einer Ressource |
<resource>:read | nur lesen (GET/HEAD) |
<resource>:write | schreiben, schließt Lesen ein |
Hinweis: Ressourcen sind z. B. orders, documents, tours, invoices, partners, webhooks, stock. Empfehlung: je Fremdsystem ein eigener Schlüssel mit minimalen Scopes – etwa TMS-Import orders:write, documents:write, BI orders:read, invoices:read. Fehlt ein Scope: 403 api_key_scope. Limit: 600 Anfragen pro Minute und IP.
Verwandte Artikel
- IntegrationenFrachtenbörse, Telematik, Buchhaltung, E-Mail, Routing, Geocoding, Sanktionsliste und E-Rechnung anbinden, testen und überwachen.
- Benutzer und Rollen verwaltenWelche Rolle was darf, wie Sie Benutzer einladen, bearbeiten und deaktivieren und wie Fahrer- und Portal-Logins entstehen.
- Fehlerbehebung für AdministratorenTypische Symptome – vom Mock-Modus über fehlende Mails bis zu Webhook- und Anmeldeproblemen – mit Ursache und Lösung.