Siklus hidup tugas
Mulai, lampirkan file, proses, polling, dan ambil tugas dokumen.
Mulai → lampirkan → proses → polling → unduh#
POST /v1/tasks: atur operasi sekali.POST /v1/tasks/{task_id}/uploads: dapatkan tiket unggahan langsung yang ditandatangani; gunakan titik akhir penyelesaiannya untuk melampirkan file secara otomatis.POST /v1/tasks/{task_id}/files: atau lampirkan unggahan yang sudah selesai secara terpisah sesuai urutan.POST /v1/tasks/{task_id}/process: kirimkan opsi yang tidak dapat diubah dan antrikan satu pekerjaan yang dikenakan biaya.GET /v1/tasks/{task_id}: periksa status eksekusi sebenarnya.GET /v1/tasks/{task_id}/download-url: terima URL output yang ditandatangani jangka pendek saat berhasil.
Daftar tugas dengan GET /v1/tasks?limit=20&offset=0, secara opsional memfilter berdasarkan alat. Anda dapat membuang tugas yang menunggu dengan DELETE; pekerjaan yang sedang diproses/selesai tidak dapat dihapus atau dibatalkan oleh endpoint ini.
{
"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"
}
}Idempoten#
Pemrosesan menggunakan satu kunci internal yang berasal dari pengenal tugas. Kirim ulang opsi identik untuk memulihkan respons yang hilang tanpa membuat biaya logis lain. Mengubah pengaturan setelah pengiriman menampilkan HTTP 409. API pekerjaan langsung warisan tetap didukung.
