Webhooks

Signatur

Webhook-Endpoints empfangen Job- und Account-Events. Payloads sind mit HMAC-SHA256 signiert.

X-Paperoffice-Signature: sha256=<hex_hmac>
Berechnen: HMAC_SHA256(webhook_secret, raw_request_body)
Anfrage ablehnen, wenn die Signaturen nicht übereinstimmen.

Ereignisse

Ereignisse: job.completed, job.failed, job.progress, document.*, workspace.*, task.* oder *.

Kontohinweise (leeres Guthaben, widerrufener Schlüssel) sind keine Webhook-Ereignisse.

Abonnement

Webhooks werden per API registriert, gelistet, aktualisiert, getestet und gelöscht.

EndpointAktion
POST /webhooks/subscribeWebhook registrieren
GET /webhooks/listAbonnements listen
POST /webhooks/updateAbonnement aktualisieren
POST /webhooks/testZustellung testen
POST /webhooks/deleteAbonnement löschen

Live-Parameterlisten: llms.txt.

Weiter