Logo PDFHQ

Dokumenty

DokumentacjaPierwsze kroki

Cykl życia zadania

Uruchamiaj, dołączaj pliki, przetwarzaj, odpytuj i pobieraj zadania związane z dokumentami.

Klucze API po stronie serwera Podpisane przesyłanie danych do magazynu

Start → dołącz → proces → ankieta → pobierz#

  • POST /v1/tasks: ustaw operację raz.
  • POST /v1/tasks/{task_id}/uploads: uzyskaj podpisany bilet bezpośredniego przesyłania; użyj punktu końcowego zakończenia, aby automatycznie dołączyć plik.
  • POST /v1/tasks/{task_id}/files: alternatywnie dołącz osobno ukończone przesyłki w kolejności.
  • POST /v1/tasks/{task_id}/process: prześlij niezmienne opcje i wstaw do kolejki jedno płatne zadanie.
  • GET /v1/tasks/{task_id}: sprawdź rzeczywisty status wykonania.
  • GET /v1/tasks/{task_id}/download-url: po pomyślnym otrzymaniu krótkotrwałego podpisanego wyjściowego adresu URL.

Lista zadań z GET /v1/tasks?limit=20&offset=0, opcjonalnie filtrowanie według narzędzia. Możesz odrzucić oczekujące zadania za pomocą DELETE; Przetwarzanie/ukończone zadania nie mogą zostać usunięte ani anulowane przez ten punkt końcowy.

Rozpocznij odpowiedź na zadanie (przedstawiciel)
{
  "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"
  }
}

Idempotencja#

Do przetwarzania wykorzystuje się jeden klucz wewnętrzny pochodzący z identyfikatora zadania. Wyślij ponownie identyczne opcje, aby odzyskać utraconą odpowiedź bez tworzenia kolejnego obciążenia logicznego. Zmiana ustawień po przesłaniu zwraca protokół HTTP 409. Starszy interfejs API zadań bezpośrednich jest nadal obsługiwany.

Logo PDFHQ

Narzędzia PDF i inteligencja dokumentów. Przygotuj, zrozum i pracuj ze swoimi dokumentami.

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.