Aufgaben-Lebenszyklus
Starten, Dateien anhängen, verarbeiten, abrufen und Dokumentaufgaben abrufen.
Start → anhängen → verarbeiten → abfragen → herunterladen#
POST /v1/tasks: Stelle die Operation einmalig ein.POST /v1/tasks/{task_id}/uploads: Erhalte ein signiertes Direct-Upload-Ticket; verwende seinen Completion-Endpoint, um die Datei automatisch anzuhängen.POST /v1/tasks/{task_id}/files: alternativ separat abgeschlossene Uploads in Reihenfolge anhängen.POST /v1/tasks/{task_id}/process: Übermittle unveränderliche Optionen und stelle einen berechneten Job in die Warteschlange.GET /v1/tasks/{task_id}: überprüfe den tatsächlichen Ausführungsstatus.GET /v1/tasks/{task_id}/download-url: erhalte eine kurzlebige signierte Ausgabe-URL bei Erfolg.
Liste Tasks mit GET /v1/tasks?limit=20&offset=0, optional gefiltert nach Tool. Du kannst wartende Tasks mit DELETE verwerfen; verarbeitete/abgeschlossene Jobs können von diesem Endpoint nicht gelöscht oder abgebrochen werden.
{
"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"
}
}Idempotenz#
Die Verarbeitung verwendet einen internen Schlüssel, der von der Task-ID abgeleitet ist. Sende identische Optionen erneut, um eine verlorene Antwort wiederherzustellen, ohne eine weitere logische Gebühr zu erstellen. Das Ändern von Einstellungen nach der Übermittlung gibt HTTP 409 zurück. Die ältere direkte Job-API bleibt unterstützt.
