Webhooks de firma electrónica y ciclo de vida
Devoluciones de llamada verificadas de Dropbox Sign, entrega idempotente, transiciones de estado, descargas retrasadas y reconciliación de envíos inciertos.
Devoluciones de proveedor de confianza#
Dropbox Sign envía form-data con un json campo. PDFHQ verifica la clave API principal HMAC sobre la marca de tiempo/tipo de evento y el HMAC Content-Sha256 sobre el JSON sin procesar completo. Un ID de aplicación configurado opcional también debe coincidir.
Punto final: POST /v1/esign/webhooks/dropbox-sign. Configura esta URL solo en la aplicación de API sandbox de Dropbox Sign. No expongas credenciales del proveedor en el navegador ni en solicitudes de API del cliente.
Ciclo de vida y recuperación operacional#
Los estados del sobre son draft, dispatching, sent, viewed, partially_signed, all_signed, downloadable, archiving, archived, declined, cancelled, expired, failed y needs_reconciliation. Las devoluciones de llamada verificadas del proveedor pueden llegar fuera de orden; las actualizaciones no deben retroceder a un estado completado posterior. Los eventos de devolución de llamada duplicados se persisten una sola vez usando una clave de evento única.
No descargar en absoluto_signed: Dropbox Sign aún puede preparar el archivo. Espera el evento descargable. Si un POST del proveedor agota el tiempo, no crees una segunda solicitud de firma hasta que un operador confirme el resultado original del proveedor.
Solo la cuenta y el proyecto de API que crearon un sobre pueden leer sus destinatarios, archivar su salida u obtener su enlace de descarga.
