Logo PDFHQ

Documentos

DocumentaçãoOperações PDF

API de Compressão de PDF

Comprima PDFs de forma assíncrona com configurações controladas de tamanho versus qualidade. Preserve a entrada original no armazenamento privado e busque o artefato processado com uma URL com expiração.

Chaves de API do lado do servidor Uploads de armazenamento assinado

Semântica de endpoint e tarefa#

Código de operação: compress

Inicie esta operação com POST /v1/tasks e o código da ferramenta mostrado acima. Envie e anexe PDFs de origem (ou use endpoints de upload com escopo de tarefa), depois chame POST /v1/tasks/{task_id}/process com configurações de operação.

Reduza relatórios digitalizados e anexos de email antes da distribuição.

Entradas: 1–12 uploads de PDF verificados, enviados em ordem.

Configuração e parâmetros extras#

ConfiguraçãoTipoComportamento
compression_levelstring enumrecomendado, extremo ou baixo; valores desconhecidos falham na validação. Padrão: recommended.

As opções são validadas pela API. Configurações desconhecidas e valores não suportados retornam um erro em vez de serem ignorados.

Sequência de pedido em funcionamento#

Programming language: cURL

Escolha um idioma · role horizontalmente para todos os 10 idiomas de SDK

API example · cURL
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"tool":"compress"}'

# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'

# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"compression_level":"recommended"}}'

curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'

After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.

All 10 SDKs ↓Passo a passo completo em Python ↓ Passo a passo completo em Bash/cURL ↓ Todos os endpoints → Envios diretos → Tratamento de erros →

Pacotes baixáveis gerados cobrem apenas o fluxo de trabalho da tarefa. SDKs de serviço completo requerem uma especificação OpenAPI de tempo de execução verificada; os SDKs de tarefa Python, JavaScript e TypeScript transmitem uploads de arquivo; os outros idiomas requerem uploads multipart assinados implementados pelo chamador.

O ID da tarefa retornado é usado tanto para sondagem de status quanto para recuperação. Após a tarefa ter sucesso, solicite uma URL de saída assinada em vez de incorporar um segredo de download.

Saída e detalhes importantes#

PDF de saída ou ZIP conforme selecionado pelo pipeline de processamento subjacente.

Compressão não é uma garantia de saída menor para cada PDF. Verifique o tamanho de saída real.

Erros, tentativas e faturamento
Logo PDFHQ

Ferramentas PDF e inteligência de documentos. Prepare, compreenda e trabalhe com seus documentos.

© 2026 PDFHQ. Todos os direitos reservados.