Logotipo de PDFHQ

Documentos

DocumentaciónPrimeros pasos

Ciclo de vida de tarea

Inicia, adjunta archivos, procesa, consulta y recupera tareas de documentos.

Claves de API del lado del servidor Cargas de almacenamiento firmadas

Iniciar → adjuntar → procesar → sondear → descargar#

  • POST /v1/tasks: establezca la operación una sola vez.
  • POST /v1/tasks/{task_id}/uploads: obtén un ticket de carga directa firmado; usa su endpoint de finalización para adjuntar el archivo automáticamente.
  • POST /v1/tasks/{task_id}/files: alternativamente adjunta cargas completadas por separado en orden.
  • POST /v1/tasks/{task_id}/process: envía opciones inmutables y pone en cola un trabajo cobrado.
  • GET /v1/tasks/{task_id}: inspecciona el estado de ejecución real.
  • GET /v1/tasks/{task_id}/download-url: recibe una URL de salida firmada de corta duración cuando es exitoso.

Listar tareas con GET /v1/tasks?limit=20&offset=0, opcionalmente filtrando por herramienta. Puedes descartar tareas en espera con DELETE; los trabajos en procesamiento/completados no pueden ser eliminados o cancelados por este endpoint.

Respuesta de tarea de inicio (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"
  }
}

Idempotencia#

El procesamiento utiliza una clave interna derivada del identificador de tarea. Reenvía opciones idénticas para recuperar una respuesta perdida sin crear otro cargo lógico. Cambiar configuración después del envío devuelve HTTP 409. La API de trabajo directo heredada sigue siendo compatible.

Logotipo de PDFHQ

Herramientas PDF y análisis de documentos. Prepara, comprende y trabaja con tus documentos.

© 2026 PDFHQ. Todos los derechos reservados.