Görev yaşam döngüsü
Belge görevlerini başlatın, dosya ekleyin, işleyin, yoklayın ve alın.
Başlat → ekle → işle → yokla → indir#
POST /v1/tasks: işlemi bir kez ayarlayın.POST /v1/tasks/{task_id}/uploads: imzalı doğrudan yükleme bileti alın; dosyayı otomatik olarak eklemek için tamamlama uç noktasını kullanın.POST /v1/tasks/{task_id}/files: alternatif olarak ayrı olarak tamamlanmış yüklemeleri sırayla ekleyin.POST /v1/tasks/{task_id}/process: değişmez seçenekleri gönder ve bir ücretli işi kuyruğa al.GET /v1/tasks/{task_id}: gerçek yürütme durumunu kontrol edin.GET /v1/tasks/{task_id}/download-url: başarılı olduğunda kısa ömürlü imzalı çıktı URL'si alın.
Görevleri şununla listele GET /v1/tasks?limit=20&offset=0, isteğe bağlı olarak araca göre filtreleyebilirsiniz. DELETE ile bekleyen görevleri silebilirsiniz; işlenen/tamamlanan işler bu uç nokta tarafından silinemez veya iptal edilemez.
{
"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"
}
}İdempotentlik#
İşleme, görev tanımlayıcısından türetilen bir iç anahtar kullanır. Başka bir mantıksal ücret oluşturmadan kayıp bir yanıtı kurtarmak için özdeş seçenekleri yeniden gönderin. Gönderimden sonra ayarları değiştirmek HTTP 409 döndürür. Eski doğrudan iş API'si desteklenmeye devam eder.
