Logo PDFHQ

Dokumenty

DokumentacjaPierwsze kroki

Bezpośrednie przesyłanie plików PDF

Bezpieczne przesyłanie wstępnie określonej pamięci, sumy kontrolne SHA-256, zakończenie przesyłania i wygaśnięcie.

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

Biblioteka dokumentów#

Po zapieczętowaniu przesłanego pliku zarejestruj jego upload_id i tytuł za pomocą POST /v1/workspace/documents. Biblioteka przechowuje referencje dotyczące konta i klucza API o określonym zakresie, bez kopiowania pliku i przedłużania jego pierwotnej ważności.

Wyświetl, zmień nazwę i usuń odwołania w /v1/workspace/documents. Punkty końcowe podglądu i aktywności ponownie sprawdzają własność i wygaśnięcie. PUT / {document_id}/retention akceptuje znacznik czasu retained_until, który może jedynie skrócić dostępność. Usunięcie pliku referencyjnego powoduje, że oryginalny plik podlega istniejącym zasadom przechowywania.

POST /{document_id}/handoff/task dołącza źródło do zadania; /handoff/ai wymaga normalnego cytatu, wyraźnej zewnętrznej zgody AI i klucza Idempotencji; /handoff/signing tworzy wersję roboczą do osobnego przejrzenia i wysłania. OAuth wymaga plików.read lub files.write do operacji bibliotecznych, Jobs.write do przekazywania zadań, ai.write do przekazywania AI i podpisów.write do przekazywania podpisywania.

Wstęp do pliku#

Poproś o wcześniej zaplanowane przesłanie za pomocą POST /v1/documents/uploads z nazwą pliku, content_type=application/pdf, size_bytes i małą literą SHA-256 określającą dokładne bajty źródłowe. Odpowiedź zawiera adres URL POST S3 i podpisane wieloczęściowe pola formularza.

Wyślij wszystkie zwrócone pola w stanie niezmodyfikowanym i plik na adres URL S3. Następnie zadzwoń POST /v1/documents/uploads/{upload_id}/complete w celu sprawdzenia rozmiaru i metadanych oraz zapieczętowania obiektu. Do zadań można dołączać tylko gotowe przesłane pliki. Wolę POST /v1/tasks/{task_id}/uploads oraz zwrócony link umożliwiający automatyczne dołączenie pliku.

cURL
curl -X POST https://api.pdfhq.io/v1/documents/uploads \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"filename":"report.pdf","content_type":"application/pdf","size_bytes":12345,"sha256":"ACTUAL_64_CHAR_DIGEST"}'

Prywatność i ograniczenia#

Przesyłanie zadania może być dołączone tylko do jednego zadania. Prześlij bilety wygasają; rozmiar, podpis PDF i streszczenie muszą się zgadzać. Nie utrwalaj podpisanych adresów URL ani nie rejestruj poufnej zawartości plików. Klienci mogą usunąć nieużywane przesłane pliki przed przesłaniem ich do zadania.

Logo PDFHQ

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

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.