API Document Library e handoff di flusso di lavoro sicuro
Registra caricamenti PDF sigillati di proprietà, ispeziona metadati privati e attività, accorcia la conservazione e riutilizza un caricamento esistente in compiti, job AI quotati o bozze di firma sandbox.
Registra un PDF esistente e sigillato#
Carica prima direttamente nell'archivio privato con POST /v1/documents/uploads e POST /v1/documents/uploads/{upload_id}/complete. Un caricamento è utilizzabile solo dopo che il server lo sigilla e verifica. Le chiavi API sono limitate all'account HQTools originale e al progetto API.
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 elenca solo i riferimenti disponibili. GET /v1/workspace/documents/{document_id} verifica nuovamente la proprietà del caricamento originale e la scadenza. DELETE rimuove la voce dalla libreria, non il caricamento sottostante archiviato.
Anteprima privata e conservazione#
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_KEYL'endpoint preview-url restituisce un URL autorizzato per l'archiviazione privata con una durata massima di 60 secondi, limitato dalla conservazione dell'origine e della libreria. Tratta la sua query firmata come un segreto e non registrarla o memorizzarla nella cache. L'endpoint preview deprecato è limitato a 4 MiB e verifica l'origine sigillata prima di restituire i byte. I record di attività GET sono limitati allo stesso account e progetto API. PUT /retention può solo accorciare la disponibilità della libreria; non può estendere la conservazione del caricamento sigillato.
Passaggio all'elaborazione PDF, AI Studio o firma#
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}]}Il passaggio di un'attività non genera addebiti. Il passaggio all'AI richiede il normale preventivo, il consenso all'AI esterna, l'isolamento del progetto e l'autorizzazione tramite un unico portafoglio di crediti HQ. La firma crea solo una bozza: l'invio di una richiesta sandbox richiede una conferma esplicita separata. I documenti scaduti o non appartenenti all'utente non vengono mai accettati.
