Logo PDFHQ

Documentos

DocumentaçãoPrimeiros passos

Verificação prévia ao carregamento

Verifique a elegibilidade da operação PDF, os metadados assinados, os limites de lote e as estimativas de créditos HQ antes de selar ou carregar ficheiros.

Chaves de API do lado do servidor Uploads de armazenamento assinado

Validar operações PDF sem carregar ficheiros#

POST /v1/preflight valida a operação PDF proposta, os metadados, as definições, as restrições do plano e uma estimativa indicativa de créditos HQ sem atribuir armazenamento, criar tarefas nem cobrar créditos. Forneça format, size_bytes e page_count de cada ficheiro. A autenticação utiliza uma sessão de conta ou uma chave API com permissões para tarefas; pedidos anónimos limitados não podem consultar saldos.

cURL
curl -X POST 'https://api.pdfhq.io/v1/preflight'   -H 'Content-Type: application/json'   -H 'x-api-key: YOUR_API_KEY'   -d '{"operation":"merge","inputs":[{"format":"pdf","size_bytes":51200,"page_count":2},{"format":"pdf","size_bytes":40960,"page_count":3}],"file_count":2,"settings":{}}'

Consulte supported, eligible, can_proceed, blockers, quote e next_actions. Apenas uma oferta verificada centralmente pela HQTools pode resolver um bloqueio que admite compra. Um pedido tecnicamente não suportado não deve apresentar uma barreira de pagamento.

Execução e segurança#

Os limites de pedidos e a validação rigorosa protegem o ponto de acesso anónimo. Uma verificação prévia bem-sucedida não reserva créditos, não fixa preços nem comprova o conteúdo dos PDF carregados. Assine e carregue diretamente para o armazenamento, crie a tarefa e deixe o servidor voltar a validar os documentos reais, as permissões, as quotas e os créditos HQ durante a execução.

Os SDK de referência disponibilizam preflight(request) em dez linguagens e a especificação OpenAPI ativa /openapi.json descreve os contratos públicos. Trate as respostas HTTP 422 (validação), 429 (limite de pedidos) e 503 (indisponível).

Logo PDFHQ

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

© 2026 PDFHQ. Todos os direitos reservados.