Logo PDFHQ

Dokumenty

DokumentacjaDokumenty i informacje wywiadowcze

Interfejs API biblioteki dokumentów i bezpieczne przekazywanie przepływu pracy

Rejestruj posiadane zapieczętowane przesyłane pliki PDF, sprawdzaj prywatne metadane i aktywność, skróć przechowywanie i ponownie wykorzystuj istniejące przesłane pliki w zadaniach, cytowanych zadaniach AI lub podpisach roboczych w piaskownicy.

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

Zarejestruj istniejący, zapieczętowany plik PDF#

Najpierw prześlij bezpośrednio do prywatnej pamięci za pomocą POST /v1/documents/uploads i POST /v1/documents/uploads/{upload_id}/complete. Przesyłanie będzie możliwe dopiero po jego zapieczętowaniu i zweryfikowaniu przez serwer. Klucze API są ograniczone do oryginalnego konta HQTools i projektu API.

cURL
POST https://api.pdfhq.io/v1/workspace/documents
x-api-key: PROJECT_API_KEY
Content-Type: application/json

{"upload_id":"SEALED_UPLOAD_UUID","title":"Review draft"}

GET /v1/workspace/documents wyświetla tylko dostępne odniesienia. GET /v1/workspace/documents/{document_id} ponownie sprawdza własność oryginalnego przesłanego pliku i jego wygaśnięcie. DELETE usuwa wpis biblioteki, a nie podstawowy zapisany plik przesłany.

Prywatny podgląd i przechowywanie#

cURL
GET https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/preview-url
x-api-key: PROJECT_API_KEY

GET https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/activity
x-api-key: PROJECT_API_KEY

Punkt końcowy adresu URL podglądu zwraca autoryzowany adres URL magazynu prywatnego o maksymalnym czasie życia 60 sekund, ograniczonym przechowywaniem źródła i biblioteki. Traktuj podpisane zapytanie jako tajne i nie rejestruj go ani nie buforuj. Przestarzały punkt końcowy podglądu jest ograniczony do 4 MiB i weryfikuje zapieczętowane źródło przed zwróceniem bajtów. Rekordy aktywności GET są ograniczone do tego samego konta i projektu API. PUT /retention może jedynie skrócić dostępność biblioteki; nie może przedłużyć okresu przechowywania zapieczętowanych plików.

Przekazanie do przetwarzania plików PDF, AI Studio lub podpisywania#

cURL
POST https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/handoff/task
x-api-key: PROJECT_API_KEY
Content-Type: application/json

{"task_id":"OWNED_TASK_UUID"}

POST https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/handoff/ai
x-api-key: PROJECT_API_KEY
Idempotency-Key: NEW_IDEMPOTENCY_KEY
Content-Type: application/json

{"operation":"pdfhq.ai.summarize","quote_id":"OWNED_HQTOOLS_QUOTE","question":"Key risks?","allow_external_ai":true}

POST https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/handoff/signing
x-api-key: PROJECT_API_KEY
Content-Type: application/json

{"provider":"managed","title":"Review agreement","subject":"Please review","signers":[{"name":"Sample Signer","email":"signer@example.com","order":0}]}

Przekazanie zadania nie powoduje opłaty. Przekazanie do AI wymaga standardowej wyceny, zgody na zewnętrzną AI, izolacji projektu i dopuszczenia za pomocą jednego portfela kredytów HQ. Podpisanie tworzy tylko wersję roboczą: wysłanie żądania do środowiska testowego wymaga osobnego, wyraźnego potwierdzenia. Wygasłe lub cudze dokumenty są zawsze odrzucane.

Logo PDFHQ

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

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.