Webhooks
Docs/API und Webhooks

Render-Webhooks einrichten

Erstellen Sie einen Endpunkt, um Benachrichtigungen zu erhalten, wenn sich der Status eines PDF-Renderings ändert.

1 Minuten Lesezeit6 Abschnitte
Auf dieser Seite

Statusbenachrichtigungen

Ihre Anwendung kann Benachrichtigungen zum Renderstatus empfangen, anstatt wiederholt Abfragen durchzuführen. Behalten Sie die Render-ID und die Statussuche bei, um die Ergebnisse abzugleichen.

1. Bereiten Sie einen Empfänger vor

Verwenden Sie einen öffentlich erreichbaren HTTPS-Endpunkt, kein lokales Host/privates Netzwerk. Signaturen überprüfen; Eine plausibel aussehende Leiche ist kein Herkunftsnachweis.

2. Erstellen Sie einen Endpunkt in der App

Öffnen Sie Projekt-Webhooks, geben Sie einen Namen und eine URL ein und speichern Sie dann das Signaturgeheimnis sicher in Ihrem Backend. Das Geheimnis wird bei der Schöpfung enthüllt; Halten Sie es aus Frontend-Code und Screenshots fern.

3. Senden Sie einen Test

Verwenden Sie Testen und überprüfen Sie den HTTP-Status, die Versuche und Fehler der Zustellung. Ein webhook.test-Ereignis ist kein abgeschlossenes PDF.

4. Behandeln Sie Renderereignisse

Echte Benachrichtigungen verwenden renders.status. Erhalten Sie den Empfang sicher und reagieren Sie zeitnah, führen Sie dann eine längere Bearbeitung separat durch. Bestätigen Sie nicht, bevor Ihr System das Ereignis zuverlässig speichern kann.

Betreiben Sie den Endpunkt

Bewusstes Aktivieren/Deaktivieren und Verwendung des Lieferverlaufs zur Diagnose. Reparieren Sie einen vorhandenen Endpunkt, anstatt Duplikate zu erstellen. Lesen Sie die Signaturüberprüfung, bevor Sie echte Daten verarbeiten.

Dokumentation durchsuchen