Belge Kütüphanesi API'si ve güvenli iş akışı el değiştirmeleri
Sahip olunan mühürlü PDF yüklemelerini kaydedin, özel meta verileri ve etkinliği inceleyin, saklama süresini kısaltın ve mevcut bir yüklemeyi görevlerde, alıntı yapılan AI işlerinde veya korumalı alan imzalama taslakları içinde yeniden kullanın.
Mevcut, kapalı PDF'yi kaydet#
Önce POST /v1/documents/uploads ve POST /v1/documents/uploads/{upload_id}/complete ile doğrudan özel depolamaya yükleyin. Bir yükleme, sunucu tarafından mühürlendikten ve doğrulandıktan sonra kullanılabilir. API anahtarları orijinal HQTools hesabı ve API projesine kapsamlıdır.
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 yalnızca mevcut referansları listeler. GET /v1/workspace/documents/{document_id} orijinal yükleme sahipliğini ve son kullanma tarihini yeniden kontrol eder. DELETE kütüphane girişini kaldırır, altta yatan depolanan yüklemeyi değil.
Özel önizleme ve saklama#
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Ön izleme URL uç noktası, maksimum 60 saniyelik ömrü olan özel depolama için yetkili bir URL döndürür ve kaynak ve kitaplık saklama ile sınırlandırılır. İmzalı sorgusunu gizli olarak değerlendirin ve günlüğe kaydetmeyin veya önbelleğe almayın. Kullanımdan kaldırılan ön izleme uç noktası 4 MiB ile sınırlıdır ve baytları döndürmeden önce mühürlü kaynağı doğrular. GET etkinlik kayıtları aynı hesap ve API projesi ile sınırlıdır. PUT /retention yalnızca kitaplık kullanılabilirliğini kısaltabilir; mühürlü yükleme saklama süresini uzatamazız.
PDF işlemeye, AI Studio'ya veya imzalamaya devret#
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}]}Bir görevin devredilmesi ücret oluşturmaz. Yapay zekâya devretme, normal fiyat teklifini, harici yapay zekâ onayını, proje yalıtımını ve tek HQ kredisi cüzdanıyla kabulü gerektirir. İmzalama yalnızca taslak oluşturur: test ortamına istek göndermek için ayrıca açık onay gerekir. Süresi dolmuş veya başkasına ait belgeler asla kabul edilmez.
