Quando você precisa de um PDF em Base64?
JSON, XML e muitos formulários só transportam texto, então um arquivo binário como o PDF precisa primeiro ser escrito como texto. O Base64 é a forma mais comum de fazer isso:
- Enviar um documento para uma API. Serviços de nota fiscal eletrônica, assinatura eletrônica, frete e gestão de documentos costumam pedir o PDF em um campo chamado content, file ou data.
- Testar a sua própria integração. Com a opção JSON, você recebe um corpo de requisição pronto para colar no Postman, no curl ou em um teste unitário, sem precisar programar a codificação.
- Guardar em uma coluna de texto ou em uma configuração. Alguns sistemas guardam modelos pequenos ou certificados como texto; o Base64 faz o PDF caber ali.
- Incorporar em uma página web. Uma data URI permite que a página mostre um PDF em um iframe sem hospedar um arquivo separado — funciona bem para documentos pequenos.
Exemplos de requisição passo a passo em curl, JavaScript e Python estão em Como enviar um PDF para uma API em Base64. Para transformar o código de volta em arquivo, use Base64 para PDF; para imagens, veja Imagem para Base64.
Como fica cada formato
| Formato | Começa com | Uso típico |
|---|---|---|
| Só o código Base64 | JVBERi0 | Campos de API, JSON, XML, bancos de dados |
| Data URI | data:application/pdf;base64, | Aba do navegador, iframe, tag object |
| Linhas de 76 caracteres | JVBERi0, quebrado em linhas curtas | Anexos de e-mail (MIME), arquivos no estilo PEM |
| JSON | { "fileName": … } | Corpo de requisição para testar uma integração |
Se algo der errado
"Este arquivo não é um PDF válido." O arquivo não começa com a assinatura %PDF- — pode ser um arquivo do Word ou uma imagem renomeada para .pdf. Abra o arquivo antes em um leitor de PDF ou converta-o com a ferramenta certa.
A API diz que o conteúdo é inválido. Confira se você enviou só o código, sem o prefixo data: e sem quebras de linha, a não ser que a documentação peça isso. Verifique também se nada ficou cortado no final quando você colou.
O texto é longo demais para o campo. Deixe o PDF menor com Comprimir PDF e converta de novo; o código diminui na mesma proporção.