PDFHQ logosu

Belgeler

BelgelerBaşlarken

Görev yaşam döngüsü

Belge görevlerini başlatın, dosya ekleyin, işleyin, yoklayın ve alın.

Sunucu tarafı API anahtarları İmzalı depolama yüklemeleri

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.

Görev yanıtını başlat (temsilci)
{
  "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.

PDFHQ logosu

PDF araçları ve belge zekası. Belgelerinizi hazırlayın, anlayın ve çalışın.

© 2026 PDFHQ. Tüm hakları saklıdır.