Download de Documentos em Base 64 (API)
Este endpoint da API D4Sign permite que você gere uma URL para baixar um documento no formato Base64. É uma ótima opção quando você precisa incorporar o documento diretamente em sistemas ou scripts que trabalham com essa codificação.
🚧 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-document}/download?tokenAPI={SEU-TOKEN}&cryptKey={SEU-CRYPT-KEY}
Header
O cabeçalho da sua requisição deve conter o Content-Type
como application/json
, além dos seus tokens de autenticação.
{
"Content-Type": "application/json",
"tokenAPI": "{SEU-TOKEN-API}",
"cryptKey": "{SUA-CRYPT-KEY}"
}
Body
No corpo da requisição, você vai especificar o tipo de download, o idioma e indicar que deseja a codificação Base64.
{
"type": "pdf",
"language": "pt",
"encoding": true
}
Detalhes dos Parâmetros do Body:
Parâmetro | Tipo | Obrigatoriedade | Descrição |
type |
String | Obrigatório | Escolha pdf para o formato do documento. |
language |
String | Opcional | Define o idioma do arquivo para download. Use en para inglês ou pt para português. |
encoding |
Booleano | Obrigatório | Defina como true para realizar o download do arquivo em Base64. |
Resposta (Status 200 - Sucesso)
Quando a requisição for bem-sucedida, você receberá um JSON contendo a URL final para download do documento e o nome do arquivo.
{
"url": "https://secure.d4sign.com.br/CODIGO",
"name": "teste.pdf"
}
🚧 Observações Importantes:
-
Tratamento da URL: Após baixar o arquivo usando a URL gerada por essa requisição, será necessário tratar a URL isolando os "&" comerciais. Isso significa que você precisará colocar o
&
entre aspas na URL para que o download possa ser feito corretamente via ferramentas como PowerShell. -
Exemplo de Download com PowerShell:
PowerShellcurl.exe "{URL TRATADA}" > "{NOME DO DOCUMENTO}".txt
Dessa forma, o arquivo
.txt
conterá o conteúdo do documento em Base64 na sua pasta local.