Logo PDFHQ

Documenti

DocumentazioneGuida introduttiva

Ciclo di vita dell'attività

Avvia, allega file, elabora, esegui il polling e recupera attività di documenti.

Chiavi API lato server Caricamenti di archiviazione firmati

Avvia → allega → elabora → sonda → scarica#

  • POST /v1/tasks: impostare l'operazione una sola volta.
  • POST /v1/tasks/{task_id}/uploads: ottenere un ticket di caricamento diretto firmato; utilizzare il relativo endpoint di completamento per allegare il file automaticamente.
  • POST /v1/tasks/{task_id}/files: in alternativa allega separatamente i caricamenti completati in ordine.
  • POST /v1/tasks/{task_id}/process: invia opzioni immutabili e accoda un job addebitato.
  • GET /v1/tasks/{task_id}: ispeziona lo stato di esecuzione reale.
  • GET /v1/tasks/{task_id}/download-url: ricevi un URL di output firmato di breve durata in caso di successo.

Elenca attività con GET /v1/tasks?limit=20&offset=0, filtrando facoltativamente per strumento. Puoi scartare le attività in sospeso con DELETE; i job in elaborazione/completati non possono essere eliminati o annullati da questo endpoint.

Avvia risposta attività (rappresentativa)
{
  "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"
  }
}

Idempotenza#

L'elaborazione utilizza una chiave interna derivata dall'identificatore dell'attività. Invia di nuovo opzioni identiche per recuperare una risposta persa senza creare un altro addebito logico. La modifica delle impostazioni dopo l'invio restituisce HTTP 409. L'API legacy del job diretto rimane supportata.

Logo PDFHQ

Strumenti PDF e intelligenza documentale. Prepara, comprendi e lavora con i tuoi documenti.

© 2026 PDFHQ. Tutti i diritti riservati.