Webhooks

Webhooks informieren externe Systeme über Ereignisse in QR Vello. Sie sind nützlich für CRM-Sync, Data Pipelines, Alerting oder eigene Admin-Oberflächen.

Status

Webhook-Endpunkte, Secrets und Testzustellung sind im Dashboard vorhanden. Signaturen sind Teil des Beta-Scope. Event-Abdeckung und Retry-Policy werden öffentlich erst als stabil bezeichnet, wenn die Doku diese Details vollständig festschreibt.

Einrichtung

1. Öffne /qr/webhooks.
2. Lege einen HTTPS-Endpunkt an.
3. Kopiere das Secret direkt nach der Erstellung. Es wird nur einmal im Klartext angezeigt.
4. Sende eine Testzustellung.
5. Prüfe Statuscode, Latenz und Payload in deinem System.

Signaturen

Prüfe Webhook-Payloads serverseitig, bevor du sie verarbeitest. Das Ziel:

• Payload stammt von QR Vello.
• Payload wurde unterwegs nicht verändert.
• Alte Events werden nicht erneut als neu akzeptiert.

Events

Öffentlich beworben werden nur Events, die in der Doku mit Status beschrieben sind. Aktuell verwendete Eventnamen können unter anderem QR-Code-Änderungen, Scans und Job-Status betreffen. Für Enterprise-Integrationen stimmen wir den benötigten Event-Scope vor Go-live ab.

Empfänger-Regeln

• Antworte schnell mit 2xx, wenn dein System das Event angenommen hat.
• Verarbeite langsamere Arbeit asynchron in deiner Queue.
• Logge Event-ID, Zeitstempel und Signaturprüfung.
• Baue Idempotenz ein, damit Wiederholungen keinen doppelten Effekt haben.