Taaklevenscyclus
Start, voeg bestanden toe, verwerk, poll en haal documenttaken op.
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.
{
"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.
