Como enviar um PDF para uma API em Base64
Uma API de nota fiscal eletrônica, de assinatura eletrônica ou de frete quer o documento em um campo JSON. Veja como transformar o PDF no tipo certo de texto, conferir o resultado e evitar os erros que fazem a requisição falhar.
Por Metin Ersoy · Atualizado em 10 de novembro de 2026
O que a API costuma esperar
A maioria das APIs de documentos descreve um corpo JSON com um campo chamado content, file, data ou document. O valor dele é o código Base64 do PDF, muitas vezes acompanhado do nome do arquivo e do tipo:
{
"fileName": "invoice-1024.pdf",
"mimeType": "application/pdf",
"content": "JVBERi0xLjcKJ..."
}
Antes de escrever qualquer código, procure três coisas na documentação: o nome do campo, se é preciso o prefixo data: (normalmente não) e o limite de tamanho.
1. Transforme o PDF em Base64
O jeito mais rápido de ter um valor para teste é a ferramenta PDF para Base64. Selecione o PDF, escolha Só o código Base64 (começa com JVBERi0) e copie o resultado. Se quiser um corpo de requisição completo para começar, escolha JSON com nome do arquivo, tipo e conteúdo — o nome e o tipo do arquivo já vêm preenchidos. O PDF é convertido no seu navegador e não é enviado a lugar nenhum, o que faz diferença quando o documento de teste é uma nota fiscal de verdade.
Confira o resultado: ele deve começar com JVBERi0, não ter espaços e, tirando um ou dois sinais de = no final, ter só letras, números, + e /.
2. Envie pelo seu código
O mesmo passo em três linguagens comuns. Cada exemplo lê o arquivo, converte em Base64 e envia o JSON com POST:
# curl (Linux / macOS): base64 -w 0 mantém tudo em uma linha
curl -X POST https://api.example.com/documents \
-H "Content-Type: application/json" \
-d "{\"fileName\":\"invoice.pdf\",\"content\":\"$(base64 -w 0 invoice.pdf)\"}"
// Node.js 18+
import { readFile } from 'node:fs/promises';
const content = (await readFile('invoice.pdf')).toString('base64');
await fetch('https://api.example.com/documents', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ fileName: 'invoice.pdf', content }),
});
# Python 3 com requests
import base64, requests
with open("invoice.pdf", "rb") as f:
content = base64.b64encode(f.read()).decode("ascii")
requests.post("https://api.example.com/documents",
json={"fileName": "invoice.pdf", "content": content})
No macOS, a linha do curl usa base64 -i invoice.pdf em vez de -w 0. O endereço e os nomes dos campos são exemplos; use os da documentação do seu serviço.
3. Confira o caminho de volta
Se o serviço devolver o documento ou uma cópia armazenada em Base64, cole essa resposta em Base64 para PDF. Ver a primeira página e o número de páginas é a forma mais rápida de comprovar que nada se perdeu no caminho. O passo a passo do caminho inverso está em Como salvar um texto Base64 como arquivo PDF.
Erros comuns
| Sintoma | Causa provável | Solução |
|---|---|---|
| "Invalid Base64" | Quebras de linha (linhas de 76 caracteres) ou um prefixo data: | Envie só o código, em uma linha |
| "Payload too large" (413) | O PDF ficou grande demais depois da conversão | Diminua o arquivo com Comprimir PDF |
| O PDF abre em branco ou corrompido | O texto foi cortado | Converta de novo e envie o valor inteiro |
| Nomes com acento aparecem errados | Nome do arquivo enviado na codificação errada | Mantenha o corpo JSON em UTF-8 |
Quer experimentar? É grátis e o seu arquivo fica no seu dispositivo.
Abrir PDF para Base64