Ir para o conteúdo principal

Encontre sua próxima ferramenta

Documentação/API/API de PDF: mesclar, dividir, girar e comprimir
API

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.

operationEntradaCampos extras
mergesourceKeys: 2 ou mais PDFs, em ordem—
splitsourceKeypages: array com base zero; por exemplo, [0, 1, 4] mantém as páginas 1, 2 e 5
rotatesourceKeydegrees: 90, 180 ou 270
compresssourceKey— (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.

Guias relacionados