GET/me
Me
| Parameter | Ort | Beschreibung |
|---|
ERP-Schnittstelle
API-Dokumentation (nur lesend)
Basis-URL https://facility-desk.de/api/erp/v1 · Authentifizierung per Header Authorization: Bearer fdk_… · max. 600 Anfragen pro Minute und Schlüssel (danach HTTP 429 mit Retry-After).
OpenAPI 3 (JSON) herunterladen · Anleitung & Szenarien
Webhooks
Alle 5 Minuten (nur bei Änderungen) POST an Ihre HTTPS-URL mit { organization_id, sent_at, events: { "ticket.changed": [ … ] } } – die Datensätze im selben Format wie bei der API. Header X-FacilityDesk-Signature: t=ZEITSTEMPEL,v1=HEX mit HEX = HMAC-SHA256(geheimnis, ZEITSTEMPEL + "." + rohbody) und X-FacilityDesk-Webhook-Id. Bitte Signatur prüfen und Pakete mit Zeitstempel älter als 5 Minuten verwerfen.
Endpunkte
GET/{resource}
List Resource
Werte für resource: tickets, tasks, proofs, time-entries, objects, billing-areas. Antwort: { data, has_more, next_offset }.
| Parameter | Ort | Beschreibung |
|---|---|---|
| resource * | path | |
| updated_since | query | ISO-8601, nur Datensaetze mit updated_at danach |
| limit | query | |
| offset | query | |
| format | query | ^(json|csv|datev)$ |