Logo PDFHQ

Documenti

DocumentazioneDocumenti e intelligence

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.

Chiavi API lato server Caricamenti di archiviazione firmati

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.

cURL
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#

cURL
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

L'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#

cURL
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.

Logo PDFHQ

Strumenti PDF e intelligenza documentale. Prepara, comprendi e lavora con i tuoi documenti.

© 2026 PDFHQ. Tutti i diritti riservati.