PDFHQ logosu

Belgeler

BelgelerBaşlarken

Doğrudan PDF yüklemeleri

Güvenli önceden imzalanmış depolama yüklemeleri, SHA-256 sağlama toplamları, yükleme tamamlama ve sona erme.

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

Belge kitaplığı#

Bir yüklemeyi mühürledikten sonra, upload_id ve başlığını POST /v1/workspace/documents ile kaydedin. Kütüphane, dosyayı kopyalamadan veya orijinal son kullanma tarihini uzatmadan hesap ve API anahtarı kapsamlı bir referans depolar.

/v1/workspace/documents altında referansları listele, yeniden adlandır ve kaldır. Önizleme ve etkinlik uç noktaları sahiplik ve son kullanma tarihini yeniden kontrol eder. PUT / {document_id}/retention, yalnızca kullanılabilirliği kısaltabilecek bir retained_until zaman damgasını kabul eder. Bir referansın kaldırılması, orijinal yüklemeyi mevcut saklama politikası kapsamında bırakır.

POST /{document_id}/handoff/task kaynağı bir göreve ekler; /handoff/ai normal fiyat teklifini, açık harici AI iznini ve Idempotency-Key'i gerektirir; /handoff/signing, ayrı olarak incelenip gönderilmek üzere bir taslak oluşturur. OAuth, kitaplık işlemleri için files.read veya files.write'ı, görev aktarımı için jobs.write'ı, AI aktarımı için ai.write'ı ve imzalama aktarımı içinsigns.write'ı gerektirir.

Dosya kabulü#

Kullanarak imzalı bir yükleme isteği yapın POST /v1/documents/uploads dosya adı, content_type=application/pdf, size_bytes ve tam kaynak baytlarının küçük harfli SHA-256 ile. Yanıt bir S3 POST URL'si ve imzalı çok parçalı form alanları içerir.

Döndürülen tüm alanları değiştirilmeden ve dosyayı S3 URL'sine gönderin. Ardından çağırın POST /v1/documents/uploads/{upload_id}/complete boyutu ve meta verileri doğrulamak ve nesneyi mühürlemek için. Yalnızca hazır yüklemeler görevlere eklenebilir. Tercih edin POST /v1/tasks/{task_id}/uploads ve dosyayı otomatik olarak eklemek için döndürülen tamamlama bağlantısı.

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"}'

Gizlilik ve sınırlar#

Bir görev yüklemesi yalnızca bir göreve eklenebilir. Yükleme biletleri sona erer; boyut, PDF imzası ve özet eşleşmelidir. İmzalı URL'leri kalıcı hale getirmeyin veya hassas dosya içeriğini günlüğe kaydetmeyin. Müşteriler, bir işe gönderilmeden önce kullanılmayan yüklemeleri silebilir.

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.