Erros de API e tentativas
Respostas de erro estruturadas, idempotência e recuperação de processamento assíncrono.
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#
# 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.
