PDFVela — pdfvela.com
Todas as ferramentas de PDF

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 · 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

SintomaCausa provávelSoluçã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ãoDiminua o arquivo com Comprimir PDF
O PDF abre em branco ou corrompidoO texto foi cortadoConverta de novo e envie o valor inteiro
Nomes com acento aparecem erradosNome do arquivo enviado na codificação erradaMantenha o corpo JSON em UTF-8

Quer experimentar? É grátis e o seu arquivo fica no seu dispositivo.

Abrir PDF para Base64

Perguntas sobre enviar um PDF em Base64

Por que as APIs pedem Base64 em vez do arquivo?

O JSON só transporta texto. O Base64 escreve os bytes do PDF com letras, números, + e /, então o documento inteiro cabe em um único campo de texto ao lado dos outros dados, como o código do cliente ou a data da nota.

Devo enviar o prefixo data:application/pdf;base64,?

Normalmente, não. A maioria das APIs espera só o código, que começa com JVBERi0. Envie a data URI apenas quando a documentação mostrar esse formato ou quando um navegador precisar de uma URL, por exemplo em um iframe.

A API diz que o Base64 é inválido. Qual é a causa mais comum?

Quebras de linha ou um prefixo no texto, ou um código que foi cortado ao ser colado. Use só o código, em uma única linha, e confira se o final do texto chegou completo.

Qual pode ser o tamanho do PDF?

Depende do serviço, mas o texto fica cerca de um terço maior que o arquivo, então um PDF de 3 MB vira mais ou menos 4 MB de JSON. Muitas APIs param em poucos megabytes; comprimir o PDF antes é a solução mais simples.

Base64 é um tipo de criptografia?

Não. Qualquer pessoa que tenha o código consegue transformá-lo de volta no documento. Envie só por HTTPS e nunca cole um PDF confidencial em um site que envia o arquivo para um servidor.