CDRN

Descodificar um PDF Base64

  • Painel
  • Documentação
  • API
recupera um ficheiro PDF a partir da sua representação Base64, em descarregamento direto
Cole a cadeia Base64 do PDF, com ou sem prefixo Data URI (data:application/pdf;base64,...).

Descodificar um PDF Base64

Esta ferramenta recebe uma cadeia Base64 que representa um ficheiro PDF, descodifica-a e devolve o PDF original em descarregamento direto. É a operação inversa do nosso codificador PDF Base64.

Porquê descodificar um PDF Base64?

  • Recuperar um PDF recebido em JSON: uma API devolve um documento assinado, uma fatura ou um relatório sob a forma de cadeia Base64 numa chave JSON. Para o visualizar, é preciso descodificá-lo.
  • Debug de integração de API: confirmar que a cadeia Base64 devolvida por um serviço terceiro corresponde mesmo a um PDF válido e legível.
  • Recuperação de arquivos: extrair um PDF a partir de uma exportação JSON, de um dump de base de dados ou de um log de transação que o contenha codificado.
  • Verificação de anexos de e-mail: analisar o conteúdo Base64 de um anexo MIME para validar a sua integridade.

Como utilizar a ferramenta

  1. Cole a cadeia Base64 no campo de entrada.
  2. O prefixo data:application/pdf;base64, é opcional: a ferramenta deteta-o e remove-o automaticamente se estiver presente.
  3. Inicie a descodificação. Se a cadeia for válida e representar um PDF, aparece um botão de descarregamento.
  4. Descarregue o ficheiro reconstituído e abra-o com o seu leitor de PDF habitual.

Exemplo de cadeia aceite

data:application/pdf;base64,JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFIvRmlsdGVy...

A mesma cadeia sem o prefixo (a partir de JVBERi...) também é aceite.

Validação do formato PDF

Uma cadeia Base64 válida não garante que o conteúdo descodificado seja um PDF. A nossa ferramenta efetua uma verificação adicional: controla que os primeiros octetos descodificados correspondem mesmo ao magic header %PDF- que todo o ficheiro PDF possui no início (a assinatura 0x25 0x50 0x44 0x46 0x2D).

Se os dados descodificados não começarem por esta assinatura, a ferramenta rejeita o pedido com a mensagem "Decoded data does not look like a PDF". Este garde-fou evita propor para descarregamento um ficheiro que não abrirá, e sinaliza imediatamente um problema de formato a montante (cadeia truncada, mau tipo de ficheiro, ou conteúdo não binário).

Descarregamento direto

O PDF reconstituído é servido diretamente com um cabeçalho HTTP Content-Disposition: attachment e o tipo MIME application/pdf. Conforme o seu navegador, o ficheiro abre no visualizador integrado ou é descarregado para a pasta predefinida.

Segurança e confidencialidade

A descodificação é efetuada no lado do servidor apenas durante o pedido. O PDF reconstituído nunca é armazenado em disco nem colocado em cache: é calculado em memória e enviado em streaming diretamente para o seu navegador. Uma vez enviada a resposta, os dados são libertados.

Para documentos particularmente sensíveis (contratos, dados pessoais), prefira uma descodificação local com uma ferramenta offline (por exemplo base64 -d em linha de comandos) para que o conteúdo não transite por nenhum servidor de terceiros.

Diferença com uma imagem Base64

A nossa ferramenta é específica para PDF: recusa uma cadeia que descodifique para imagem, arquivo ZIP ou qualquer outro formato. Para descodificar uma imagem Base64 (PNG, JPEG, GIF, WebP), utilize o nosso descodificador Base64 de imagem, que valida os magic headers próprios dos formatos de imagem e oferece uma pré-visualização direta no navegador.

Perguntas frequentes

Que fazer se a ferramenta devolve "Decoded data does not look like a PDF"?

A cadeia Base64 descodifica corretamente, mas o resultado não começa por %PDF-. Isto significa ou que a cadeia está truncada, ou que o conteúdo original não é um PDF (talvez uma imagem, um documento Word, ou dados corrompidos). Verifique a fonte: a cadeia completa deve começar por JVBERi (equivalente Base64 de %PDF).

O meu PDF parece truncado depois da descodificação, porquê?

Acontece quando a cadeia Base64 de origem não está completa: um copiar-colar incompleto, uma quebra de linha mal gerida, ou um campo de base de dados que truncou o valor. Verifique se a cadeia termina mesmo (frequentemente com um ou dois = de padding) e que nenhum caractere parasita se infiltrou.

O PDF resultante é idêntico ao original?

Sim. Base64 é uma codificação reversível sem perda: a sequência de octetos descodificada é estritamente idêntica à sequência de octetos codificada. Qualquer diferença de hash ou de comportamento na abertura indica um problema a montante (cadeia danificada, fonte errada).

O prefixo Data URI é obrigatório?

Não. A nossa ferramenta aceita indistintamente a cadeia com prefixo (data:application/pdf;base64,...) ou a cadeia bruta (a partir dos dados Base64 diretamente). O prefixo é útil num contexto HTML, mas uma API que devolve o PDF num campo JSON típico fornece-o sem prefixo.

Os espaços e quebras de linha na cadeia são um problema?

Não. O descodificador ignora os caracteres brancos (espaços, quebras de linha, tabulações) que podem aparecer quando a cadeia foi formatada para apresentação. Apenas os caracteres Base64 válidos são tidos em conta.

Exemplo de pedido

curl -X POST https://cdrn.fr/api/v1/tools/base64-pdf-decoder/execute \
  -H "Content-Type: application/json" \
  -d '{"text_encoded":"..."}'

Esquema de entrada

Campo Tipo Obrigatório Predefinição
text_encoded text ✓ –

Pontos de acesso

  • GET https://cdrn.fr/api/v1/tools - lista todas as ferramentas disponíveis
  • GET https://cdrn.fr/api/v1/tools/base64-pdf-decoder - obtém o esquema desta ferramenta
  • POST https://cdrn.fr/api/v1/tools/base64-pdf-decoder/execute - executa esta ferramenta com um payload JSON