Logo PDFHQ

Documentos

DocumentaçãoPrimeiros passos

Erros de API e tentativas

Respostas de erro estruturadas, idempotência e recuperação de processamento assíncrono.

Chaves de API do lado do servidor Uploads de armazenamento assinado

Falhas HTTP previsíveis#

401/403 indica falha de autenticação ou direito de acesso. 404 oculta objetos inacessíveis. 409 sinaliza configurações imutáveis, uploads já usados ou estado de tarefa inválido. 413 impõe limites de tamanho, 422 valida configurações e 429 está limitando taxa/concorrência.

Falhas transitórias de serviço comercial ou fila retornam 503. Reprocesse com o mesmo ID de tarefa e opções idênticas, usando backoff exponencial e orçamento de tentativas limitado.

Exemplo de recuperação#

cURL
# Safe repeated processing attempt for the SAME task and options
curl -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"}}'

Uma tarefa de processamento falhada não pode ser revertida simplesmente eliminando a tarefa. Consulte o uso da conta e o suporte ao investigar discrepâncias de liquidação.

Logo PDFHQ

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

© 2026 PDFHQ. Todos os direitos reservados.