Logo PDFHQ

Documentos

DocumentaçãoPrimeiros passos

Ciclo de vida da tarefa

Inicie, anexe arquivos, processe, consulte e recupere tarefas de documentos.

Chaves de API do lado do servidor Uploads de armazenamento assinado

Iniciar → anexar → processar → consultar → descarregar#

  • POST /v1/tasks: defina a operação uma vez.
  • POST /v1/tasks/{task_id}/uploads: obtenha um ticket de upload direto assinado; use seu endpoint de conclusão para anexar o arquivo automaticamente.
  • POST /v1/tasks/{task_id}/files: como alternativa, anexe uploads concluídos separadamente em ordem.
  • POST /v1/tasks/{task_id}/process: submeter opções imutáveis e colocar uma tarefa cobrada na fila.
  • GET /v1/tasks/{task_id}: inspecione o status de execução real.
  • GET /v1/tasks/{task_id}/download-url: receba uma URL de saída assinada de curta duração quando bem-sucedido.

Listar tarefas com GET /v1/tasks?limit=20&offset=0, opcionalmente filtrando por ferramenta. Você pode descartar tarefas em espera com DELETE; trabalhos em processamento/concluídos não podem ser deletados ou cancelados por este endpoint.

Iniciar resposta de tarefa (representativa)
{
  "task_id": "uuid",
  "tool": "compress",
  "status": "waiting",
  "upload_ids": [],
  "job_id": null,
  "progress": 0,
  "output_ready": false,
  "links": {
    "self": "/v1/tasks/uuid",
    "files": "/v1/tasks/uuid/files",
    "process": "/v1/tasks/uuid/process"
  }
}

Idempotência#

O processamento usa uma chave interna derivada do identificador da tarefa. Reenvie opções idênticas para recuperar uma resposta perdida sem criar outra cobrança lógica. Alterar configurações após o envio retorna HTTP 409. A API de trabalho direto legada permanece suportada.

Logo PDFHQ

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

© 2026 PDFHQ. Todos os direitos reservados.