eSignature-Webhooks und Lebenszyklus
Verifizierte Dropbox Sign-Callbacks, idempotente Zustellung, Statusübergänge, verzögerte Downloads und Abstimmung unsicherer Sendungen.
Vertrauenswürdige Anbieter-Callbacks#
Dropbox Sign sendet form-data mit einem json Feld. PDFHQ verifiziert den primären API-Schlüssel HMAC über den Event-Zeitstempel/Typ Und das Content-Sha256 HMAC über das gesamte rohe JSON. Eine optional konfigurierte App-ID muss ebenfalls übereinstimmen.
Endpunkt: POST /v1/esign/webhooks/dropbox-sign. Konfiguriere diese URL nur in der Dropbox Sign Sandbox-API-App. Gib Provider-Anmeldedaten nicht im Browser oder in Customer-API-Anfragen preis.
Lebenszyklus und operative Wiederherstellung#
Umschlagzustände sind draft, dispatching, sent, viewed, partially_signed, all_signed, downloadable, archiving, archived, declined, cancelled, expired, failed und needs_reconciliation. Verifizierte Anbieter-Callbacks können außer Reihenfolge ankommen; Updates dürfen einen späteren abgeschlossenen Zustand nicht rückgängig machen. Doppelte Callback-Events werden einmalig mit einem eindeutigen Event-Schlüssel beibehalten.
Nicht herunterladen bei all_signed: Dropbox Sign kann die Datei möglicherweise noch vorbereiten. Warte auf das downloadable-Ereignis. Wenn ein Provider-POST abläuft, erstelle keine zweite Signieranfrage, bis ein Operator das Ergebnis des ursprünglichen Providers bestätigt.
Nur das Konto und das API-Projekt, das eine Hülle erstellt hat, können ihre Empfänger lesen, ihre Ausgabe archivieren oder ihren Download-Link abrufen.
