Logo PDFHQ

Documentos

DocumentaçãoAssinatura

Webhooks de assinatura eletrônica e ciclo de vida

Callbacks verificados do Dropbox Sign, entrega idempotente, transições de status, downloads atrasados e reconciliação de envios incertos.

Chaves de API do lado do servidor Uploads de armazenamento assinado

Callbacks de provedor confiável#

Dropbox Sign envia form-data com um json campo. PDFHQ verifica a chave de API primária HMAC sobre o carimbo de data/hora do evento e o HMAC Content-Sha256 sobre todo o JSON bruto. Um ID de aplicação configurado opcional também deve corresponder.

Ponto final: POST /v1/esign/webhooks/dropbox-sign. Configure este URL apenas no aplicativo sandbox da API Dropbox Sign. Não exponha credenciais do provedor no navegador ou em solicitações de API do cliente.

Ciclo de vida e recuperação operacional#

Os estados do envelope são rascunho, envio, enviado, visualizado, partially_signed, all_signed, para download, arquivamento, arquivado, recusado, cancelado, expirado, com falha e needs_reconciliation. Os retornos de chamada do provedor verificado podem chegar fora de serviço; as atualizações não devem regredir para um estado concluído posteriormente. Eventos de retorno de chamada duplicados são persistidos uma vez usando uma chave de evento exclusiva.

Não descarregue em all_signed: O Dropbox Sign pode ainda preparar o ficheiro. Aguarde o evento descarregável. Se um POST do fornecedor expirar, não crie um segundo pedido de assinatura até que um operador confirme o resultado original do fornecedor.

Apenas a conta e o projeto de API que criaram um envelope podem ler seus destinatários, arquivar sua saída ou obter seu link de download.

Logo PDFHQ

Ferramentas PDF e inteligência de documentos. Prepare, compreenda e trabalhe com seus documentos.

© 2026 PDFHQ. Todos os direitos reservados.