Reparar PDF online vs buscas por “Recovery Toolbox”: o que o PDF123 faz de fato
Buscas por “PDF recovery toolbox” quase sempre querem reparo estrutural. O Repair PDF do PDF123 é ferramenta online e API, não o desktop Recovery Toolbox for PDF.
Quando um PDF não abre, os resultados de busca misturam duas coisas bem diferentes: consertar a estrutura de um arquivo danificado e software de “recuperação” de marca para desktop. O PDF123 (pdf123.xyz), publicado como PDF Toolbox, oferece a primeira opção como ferramenta online gratuita e como API Repair PDF. Ele não é o produto para Windows vendido com o nome Recovery Toolbox for PDF.
O que “reparar” significa num PDF quebrado
Um PDF que exibe “file is damaged” ou se recusa a abrir normalmente tem um mapa interno quebrado (problemas de cross-reference ou de object stream), não imagens de página faltando que você poderia redesenhar à mão. O Repair PDF (POST /api/v1/misc/repair) reconstrói essa estrutura reescrevendo o arquivo com o qpdf a partir dos bytes que ainda são válidos. Quando a recuperação dá certo, os visualizadores voltam a abrir o arquivo sem alterar o conteúdo pretendido das páginas.
Isso é outra coisa que:
- OCR / limpeza de digitalização: quando o arquivo abre, mas o texto é só imagem (o OCR deste site devolve Markdown, não uma camada de texto oculta)
- Desbloqueio por senha: quando o arquivo está criptografado e você já sabe a senha (Desbloquear)
- Pacotes de recuperação para desktop: aplicativos instaláveis voltados a recuperação forense pesada na máquina local
- Compressão / conversão: ferramentas de tamanho e formato que ainda precisam, antes de tudo, de um PDF que possa ser interpretado
Toolbox online vs buscas por “Recovery Toolbox” para desktop
| Necessidade | Repair PDF do PDF123 | Produto típico de recuperação para desktop |
|---|---|---|
| Como você executa | Upload no navegador ou API HTTP | Instalação e execução no seu PC |
| Trabalho principal aqui | Reparo estrutural para o PDF abrir | Fluxos de recuperação específicos do fornecedor (variam por produto) |
| Automação | API Repair PDF em POST /api/v1/misc/repair |
Em geral interface gráfica ou lote local, não a nossa OpenAPI |
| Conta | Não exigida para as ferramentas do catálogo | Depende do fornecedor |
Não afirmamos paridade de recursos, preço ou detalhes de versão com o Recovery Toolbox for PDF: aquele produto é outro. Esta tabela só esclarece canal e intenção, ou seja, reparo por API online contra uma marca de recuperação para desktop que alguém pode ter digitado no Google.
Verificação prévia antes de reparar
O Get Info devolve uma checagem prévia em JSON (FileSize, PageCount, Encrypted, campos de Info, versão). Use-a para ver se o interpretador consegue carregar o arquivo e se a criptografia está bloqueando outras edições. O Repair não remove senhas. Uma árvore de decisão passo a passo para o caso “o arquivo não abre” está em O arquivo não abre: Get Info, Repair e pare de adivinhar.
Quando usar Repair e quando usar OCR
- O visualizador não abre o arquivo de jeito nenhum: tente o Repair PDF primeiro.
- O arquivo abre, mas você não consegue selecionar nem buscar texto numa digitalização: use o OCR para obter texto em Markdown; comprima à parte se o tamanho importar (fluxo do pacote de digitalização).
- Você precisa do mesmo reparo dentro de um script ou agente: chame a API Repair PDF; veja Desenvolvedores para chaves e OpenAPI. Em novas tentativas, prefira um
Idempotency-Key(Idempotency-Key).
Como é o sucesso
Depois do Repair, o visualizador deve abrir o arquivo sem o erro de “PDF danificado”, desde que objetos suficientes tenham sobrevivido. A contagem de páginas do Get Info deve bater com a do original quando a estrutura foi recuperada por inteiro. Se o arquivo ainda não abrir, novas chamadas de compressão, OCR ou conversão não vão inventar os bytes que faltam: pare e guarde o original para ferramentas forenses fora deste catálogo, se a sua política exigir.
Experimente
Envie um arquivo danificado no Repair PDF, ou chame POST /api/v1/misc/repair com uma chave de API. Mantenha o original danificado ao lado de qualquer derivado reparado. Para acesso voltado a agentes (MCP, pipeline, OpenAPI), comece por Desenvolvedores.