Logo PDFHQ

Dokumen

Siklus hidup tugas

Mulai, lampirkan file, proses, polling, dan ambil tugas dokumen.

Kunci API sisi server Unggahan penyimpanan yang ditandatangani

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.

Mulai respons tugas (representatif)
{
  "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.

Logo PDFHQ

Alat PDF dan intelijen dokumen. Siapkan, pahami, dan bekerja dengan dokumen Anda.

© 2026 PDFHQ. Semua hak dilindungi.