Logo PDFHQ

Documentos

DocumentaçãoOperações PDF

API Girar PDF

Corrigir orientação de página em PDFs, com um valor de rotação para cada documento fornecido.

Chaves de API do lado do servidor Uploads de armazenamento assinado

Semântica de endpoint e tarefa#

Código de operação: rotate

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.

Normalize páginas digitalizadas antes de arquivar ou compartilhar.

Entradas: 1–12 uploads de PDF concluídos.

Configuração e parâmetros extras#

ConfiguraçãoTipoComportamento
rotationsobrigatório integer[]Um valor por arquivo, em ordem de entrada; cada um é 0, 90, 180 ou 270.

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

# 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":{"rotations":[90]}}'

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#

Saída PDF rotacionada; vários arquivos podem produzir um arquivo.

O comprimento da matriz de rotações deve corresponder ao número de uploads de entrada.

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.