Webhook e ciclo di vita della firma elettronica
Callback Dropbox Sign verificati, consegna idempotente, transizioni di stato, download ritardati e riconciliazione di invii incerti.
Callback provider attendibili#
Dropbox Sign invia form-data con un json campo. PDFHQ verifica l'HMAC della chiave API primaria sul timestamp/tipo dell'evento e l'HMAC Content-Sha256 sull'intero JSON grezzo. Un ID app configurato opzionale deve corrispondere anche.
Punto finale: POST /v1/esign/webhooks/dropbox-sign. Configura questo URL solo nell'app sandbox dell'API Dropbox Sign. Non esporre le credenziali del provider nel browser o nelle richieste API del cliente.
Ciclo di vita e recupero operativo#
Gli stati della busta sono bozza, invio, inviato, visualizzato, parzialmente_firmato, tutto_firmato, scaricabile, archiviazione, archiviato, rifiutato, annullato, scaduto, non riuscito e necessita_riconciliazione. I callback del provider verificato possono arrivare fuori ordine; gli aggiornamenti non devono regredire uno stato completato successivo. Gli eventi di callback duplicati vengono persistiti una sola volta utilizzando una chiave evento univoca.
Non scaricare affatto at_signed: Dropbox Sign potrebbe comunque preparare il file. Attendi l'evento scaricabile. Se un POST del provider scade, non creare una seconda richiesta di firma fino a quando un operatore non conferma l'esito originale del provider.
Solo l'account e il progetto API che hanno creato una busta possono leggere i suoi destinatari, archiviare il suo output o ottenere il suo link di download.
