Doğrudan PDF yüklemeleri
Güvenli önceden imzalanmış depolama yüklemeleri, SHA-256 sağlama toplamları, yükleme tamamlama ve sona erme.
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 -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.
