Logo PDFHQ

Documentos

DocumentaçãoOperações PDF

API de Divisão de PDF

Divida um PDF por intervalos de páginas, páginas selecionadas ou tamanho de parte alvo. Cada estratégia tem suas próprias configurações condicionais.

Chaves de API do lado do servidor Uploads de armazenamento assinado

Semântica de endpoint e tarefa#

Código de operação: split

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.

Separe pacotes grandes em arquivos individuais para revisão posterior.

Entradas: Exatamente um upload de PDF verificado.

Configuração e parâmetros extras#

ConfiguraçãoTipoComportamento
typeobrigatório range | pages | sizeSelecione exatamente uma estratégia de divisão.
rangesstringQuando type=range; intervalos baseados em 1, como 1-3,4-8.
pagesstringQuando type=pages, números de página selecionados como 1,4,7.
allPagesbooleanQuando type=pages, divida cada página. Padrão: false.
maxSizenumber (MB)Obrigatório quando type=size; maior que 0 e no máximo 50 MB.

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":"split"}'

# 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":{"type":"range","ranges":"1-3,4-8"}}'

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#

Arquivo ZIP das partes PDF extraídas.

Os números de página começam em 1. Valide as páginas solicitadas em relação ao documento de origem.

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.