API de PDF: mesclar, dividir, girar e comprimir
Mescle vários PDFs, extraia páginas, gire e comprima PDFs na nuvem com um único endpoint.
Resposta curta
Envie POST /api/v1/pdf-job/ com uma operation merge, split, rotate ou compress. Passe sourceKeys (em ordem) para merge, ou um único sourceKey para as demais; split recebe em "pages" números de página contados a partir de zero, e rotate recebe "degrees" de 90, 180 ou 270. Os arquivos vêm de um upload direto, e o resultado é um novo job de PDF que você consulta como qualquer outro.
Operações
Os arquivos já precisam estar no armazenamento da sua conta: faça o upload primeiro e use os valores objectKey retornados.
| operation | Entrada | Campos extras |
|---|---|---|
| merge | sourceKeys: 2 ou mais PDFs, em ordem | — |
| split | sourceKey | pages: array com base zero; por exemplo, [0, 1, 4] mantém as páginas 1, 2 e 5 |
| rotate | sourceKey | degrees: 90, 180 ou 270 |
| compress | sourceKey | — (perfil "ebook" do Ghostscript, imagens a 150 dpi) |
Mescle dois PDFs enviados
Para mesclar PDFs que já estão online, envie POST /api/v1/merge/ com um array "files" de 2–20 URLs de PDF, na ordem. Custa 1 crédito e retorna o PDF mesclado diretamente na resposta, em vez de um job, o que é prático em ferramentas sem código.
curl -X POST 'https://maxscanner.app/api/v1/pdf-job/' \
-H "Authorization: Bearer $MAXSCANNER_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: pack-8812-merge' \
-d '{ "operation": "merge", "filename": "pack.pdf", "sourceKeys": ["users/<id>/media/inbox/…-cover.pdf", "users/<id>/media/inbox/…-contract.pdf"] }'Limites e comportamento
Cada entrada pode ter até 100 MB, e um job até 150 MB no total. A compressão regrava as imagens a cerca de 150 dpi, o que serve bem para e-mail e uploads; PDFs de texto que já são pequenos podem não diminuir muito. PDFs criptografados precisam ser desbloqueados primeiro.
Perguntas frequentes
Os números de página começam em zero?
Na API, sim: [0] é a primeira página. As ferramentas do site numeram a partir de 1.
Posso comprimir para um tamanho exato?
Não por este endpoint. Ele aplica um único perfil equilibrado; para metas exatas, o site tem uma ferramenta de compressão por tamanho.