POST /exports. Die Antwort ist 202 Accepted mit einer Location-URL. Rufe diese URL wiederholt mit GET /exports/{id}/file auf, bis sie 200 und die Datei zurückgibt. Sende den API-Schlüssel bei jeder Anfrage. Er ist nicht Teil der Location-URL.
Nur ein Administrator kann einen Export starten oder herunterladen. Die REST API erfordert Plus. Ein Zeitraum ohne Abwesenheiten erzeugt eine Datei.
Der Auftrag erscheint außerdem unter Kürzliche Exporte auf Einstellungen > Export, mit über API neben dem anfordernden Benutzer. Jeder Admin kann dort Herunterladen wählen, sobald die Datei Bereit ist.
Formate
Sendeformat als einen dieser Werte. Sie entsprechen den Formaten unter Einstellungen > Export für einen Bereich.
Einen Export starten
start ist der erste Tag. end ist der letzte eingeschlossene Tag. Es zählt nur das UTC-Datum. Der Zeitraum darf höchstens 1826 Tage (5 Jahre) umfassen. Größere oder umgekehrte Zeiträume geben 400 zurück.
Optionales department_id begrenzt die Datei auf eine Abteilung. Lasse es weg für alle Abteilungen. Bei PAYROLL_CSV ist optionales csv_separator comma oder semicolon.
Sende den Schlüssel als X-API-KEY oder als Authorization: Bearer <key>. In einer Power Automate HTTP-Aktion setzt du Authentication auf Raw mit Bearer <key>, damit derselbe Header auch gesendet wird, wenn Power Automate der Location folgt.
Der JSON-Body eines 202 ist { "id": "...", "status": "processing" }. Rufe die Location-URL wiederholt auf. Warte die Sekunden in Retry-After (15) zwischen den Anfragen. Wenn POST /exports 429 zurückgibt, siehe API-Limits.
Die Datei herunterladen
GET /exports/{id}/file verwendet dieselben Anmeldedaten.