Download Personalizado de Documentos, Anexos e Certificados de Assinaturas Desmembrados (API)
Este endpoint da API D4Sign permite que você baixe um ou mais documentos (incluindo anexos) junto com seus respectivos certificados de assinatura (hashes), tudo em um pacote zipado. É super prático para arquivar ou auditar documentos e suas provas de autenticidade.
🚧 Importante: Não esqueça de enviar o tokenAPI e cryptKey em sua requisição.
Exemplo de URL completa para requisição: https://secure.d4sign.com.br/api/v1/documents/{uuid-main-document}/downloadlist?tokenAPI={SEU-TOKEN}&cryptKey={SEU-CRYPT-KEY}
Header
O cabeçalho da sua requisição deve conter o Content-Type
como application/json
e indicar que você aceita application/json
como formato de resposta, além dos seus tokens de autenticação.
{
"Accept": "application/json",
"Content-Type": "application/json",
"tokenAPI": "{SEU-TOKEN-API}",
"cryptKey": "{SUA-CRYPT-KEY}"
}
Body
No corpo da requisição, você vai listar os UUIDs dos documentos que deseja baixar e indicar se quer incluir a hash (certificado de assinatura) de cada um.
{
"language": "pt",
"type":"pdf",
"documents": {
"uuid-slave-document1": "0",
"uuid-slave-document2": "0"
}
}
Detalhes dos Parâmetros do Body:
Parâmetro | Tipo | Obrigatoriedade | Descrição |
language |
String | Opcional | Define o idioma dos arquivos para download. Use en para inglês ou pt para português. |
type |
String | Opcional | Escolha o formato de download. Se excluído, o download será em PDF. Para baixar no formato PDF/A, defina como "pdfa" . |
documents |
Objeto | Obrigatório | Um objeto onde cada chave é o UUID de um documento (pode ser o documento principal ou um anexo), e o valor indica se você quer baixar a hash (certificado digital) junto ao documento: 1 para sim (true) ou 0 para não (false). Você pode incluir múltiplos UUIDs. |
uuid-slave-documentX |
String | Obrigatório | O UUID do documento que você quer baixar (ex: uuid-slave-document1 , uuid-do-documento-principal , etc.). O X é um contador. |
Resposta (Status 200 - Sucesso)
Quando a requisição for bem-sucedida, você receberá um JSON com a URL para download do arquivo .zip
contendo todos os documentos e hashes solicitados.
{
"url": "https://secure.d4sign.com.br/CODIGO"
}
🚧 Observações Importantes:
-
Documento Finalizado: Para que o download seja efetuado com sucesso, o documento (e seus anexos, se aplicável) precisa estar finalizado, ou seja, todos os signatários devem ter assinado.
-
Formato de Saída: O retorno desse POST é uma URL para download de um arquivo ZIP, que conterá os documentos e hashes que você listou no
Body
.