Automatizar PDF com n8n, Make ou Zapier usando API HTTP

Para automatizar a compressão de PDF no n8n, no Make ou no Zapier, use um passo de requisição HTTP que faça POST para https://api.ajustapdf.com/pdf/compress, em multipart/form-data, com o arquivo no campo file e o nível no campo level. A resposta é o próprio PDF comprimido. Não há chave de API, mas a cota sem conta é de 3 operações por dia, então o fluxo serve para testes e volumes pequenos.

O que a API faz e o que ela não faz

A API expõe as mesmas operações do site, cada uma com um caminho próprio: comprimir, juntar, proteger, remover senha, dividir, girar, converter para imagem, montar PDF a partir de imagens, organizar e aplicar marca d'água. Para a automação, a operação mais útil costuma ser a compressão, porque ela roda antes de um envio por e-mail ou portal. O guia API para comprimir PDF: como chamar por HTTP com curl lista todos os caminhos e os códigos de erro.

A API não faz OCR, não converte PDF para Word e não edita o texto de um PDF. Se o fluxo precisa dessas etapas, elas ficam em outra ferramenta, e a API entra só para o que ela faz bem.

Montar o passo no n8n

No n8n, o caminho usual é o nó HTTP Request. Ele recebe o PDF de um passo anterior, como um download do Drive ou um anexo de e-mail, e o envia como arquivo binário. Os nomes dos campos das telas mudam entre versões, então confira estes três pontos:

1. Método POST, com a URL https://api.ajustapdf.com/pdf/compress.
2. Corpo em multipart/form-data, com o arquivo binário no campo chamado file. O nome do campo precisa ser exatamente file.
3. Campo de texto level com o valor leve, media ou forte. Sem o campo, o servidor usa o nível médio.

Na saída, escolha o formato de resposta binária, para que o próximo nó receba o PDF e não um texto. Se o próximo nó gravar um arquivo vazio, quase sempre é porque a resposta foi tratada como texto.

Montar o passo no Make e no Zapier

No Make, use o módulo de requisição HTTP com o mesmo método, a mesma URL e o mesmo corpo em multipart. No Zapier, a alternativa é um passo de requisição customizada, mas o upload de arquivo binário depende do recurso disponível no seu plano e no passo escolhido. Teste com um PDF pequeno antes de montar o restante do fluxo.

Tratar cota, limite e erro

A API responde com códigos específicos, e o fluxo deve reagir a cada um. O erro 402 com QUOTA_EXCEEDED mostra que o limite diário do plano acabou. O erro 402 com FILE_TOO_LARGE indica arquivo acima do tamanho do plano, e TOO_MANY_FILES indica arquivos demais na mesma operação. O erro 429 com TOO_MANY_REQUESTS aparece quando há muitas operações vindas da mesma rede no dia, mesmo sem a cota diária estar esgotada.

Em respostas de sucesso, os cabeçalhos x-quota-used e x-quota-limit mostram o consumo do dia. Use-os para registrar quanto ainda resta, em vez de descobrir o limite pelo erro. O endereço https://api.ajustapdf.com/pdf/limits também informa o plano e o uso atual, e não gasta operação. Antes de um lote grande, consulte esse endereço e decida quantos arquivos cabem.

1. Verifique o tamanho de cada arquivo antes de enviar. Um arquivo acima do limite do plano volta com 402 e FILE_TOO_LARGE, depois de a chamada já ter sido feita.
2. Em 200, grave a resposta e compare o tamanho com o do arquivo enviado.
3. Em 402 com QUOTA_EXCEEDED ou em 429, não repita em laço. Registre o erro e espere.
4. Em 504 com TIMEOUT, o processamento passou do tempo máximo. Tente de novo uma vez, com um arquivo menor se possível.

Quando a cota sem conta não serve

Um fluxo que roda todo dia com dezenas de arquivos esgota as 3 operações do plano sem conta na primeira execução. A API não tem chave, nem cota comprada por integração, nem contrato de processamento em escala. Ela é um caminho para testes e volumes pequenos.

Quando o volume é alto, o caminho é rodar o Ghostscript e o qpdf na sua própria infraestrutura. O guia comprimir PDF com Ghostscript e qpdf no terminal mostra os comandos. Para automações em Python ou Node que manipulam o PDF localmente, veja o guia sobre juntar e dividir PDF com Python.

Dados pessoais no fluxo

Um fluxo que recebe PDF por e-mail costuma trazer CPF, RG, comprovantes ou contratos de clientes. Quando esse arquivo vai à API, ele sai da sua rede e chega ao servidor do AjustaPDF. O servidor apaga o arquivo assim que a resposta sai e não grava o conteúdo em banco, mas a decisão de enviar o dado é sua e precisa ser feita antes de montar o fluxo. O guia sobre LGPD ao enviar documento de cliente para um site de PDF ajuda a decidir.

Como testar antes de colocar em produção

Monte o fluxo com um PDF de uma ou duas páginas, que não gasta muito da cota. Faça uma chamada e confira o status, o tamanho da resposta e se o PDF abre no leitor. Depois, troque por um arquivo real. Cada chamada conta na cota do dia, então um teste com arquivo grande só queima operações sem mostrar nada de novo sobre a integração.

Para comprimir um arquivo de forma manual, sem montar fluxo, use a ferramenta de comprimir PDF no site.

O que a automação não resolve

Automação não muda o que o arquivo contém. Se um PDF tem campos de formulário, a compressão achata o formulário: o conteúdo preenchido continua visível, mas os campos deixam de ser editáveis. Se o PDF pede senha para abrir, a API falha até que o arquivo seja desbloqueado antes. Essas regras valem para qualquer fluxo e precisam estar no desenho da automação, não só no código.