PDFHQ-logo

Documenten

DocumentatieAan de slag

Taaklevenscyclus

Start, voeg bestanden toe, verwerk, poll en haal documenttaken op.

Server-side API-sleutels Ondertekende opslagupload

Start → bijvoegen → verwerken → controleren → downloaden#

  • POST /v1/tasks: stel de bewerking eenmaal in.
  • POST /v1/tasks/{task_id}/uploads: verkrijg een ondertekend directuploadticket; gebruik het voltooiingseindpunt om het bestand automatisch bij te voegen.
  • POST /v1/tasks/{task_id}/files: voeg anders afzonderlijk voltooide uploads in volgorde toe.
  • POST /v1/tasks/{task_id}/process: onveranderbare opties indienen en één betaalde taak in de wachtrij plaatsen.
  • GET /v1/tasks/{task_id}: controleer de werkelijke uitvoeringsstatus.
  • GET /v1/tasks/{task_id}/download-url: ontvang een kortstondig ondertekende uitvoer-URL bij succes.

Taken weergeven met GET /v1/tasks?limit=20&offset=0, optioneel gefilterd op tool. U kunt wachtende taken verwijderen met DELETE; verwerkings-/voltooide taken kunnen niet door dit eindpunt worden verwijderd of geannuleerd.

Taakrespons starten (representatief)
{
  "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"
  }
}

Idempotentie#

Verwerking gebruikt één interne sleutel afgeleid van de taak-id. Verzend identieke opties opnieuw om een verloren reactie terug te krijgen zonder een ander logisch bedrag in rekening te brengen. Het wijzigen van instellingen na indiening retourneert HTTP 409. De verouderde directe taak-API blijft ondersteund.

PDFHQ-logo

PDF-tools en documentintelligentie. Bereid, begrijp en werk met uw documenten.

© 2026 PDFHQ. Alle rechten voorbehouden.