API de bibliothèque de documents et transferts de flux de travail sécurisés
Enregistrez les téléchargements PDF scellés possédés, inspectez les métadonnées privées et l'activité, raccourcissez la rétention et réutilisez un téléchargement existant dans les tâches, les tâches IA devisées ou les brouillons de signature sandbox.
Enregistrer un PDF scellé existant#
Importez d'abord directement vers le stockage privé avec POST /v1/documents/uploads et POST /v1/documents/uploads/{upload_id}/complete. Un import n'est utilisable qu'après que le serveur l'ait scellé et vérifié. Les clés API sont limitées au compte HQTools d'origine et au projet 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 liste uniquement les références disponibles. GET /v1/workspace/documents/{document_id} vérifie à nouveau la propriété de l'importation originale et l'expiration. DELETE supprime l'entrée de la bibliothèque, pas l'importation stockée sous-jacente.
Aperçu privé et conservation#
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_KEYLe point de terminaison preview-url retourne une URL autorisée pour le stockage privé avec une durée de vie maximale de 60 secondes, délimitée par la rétention source et bibliothèque. Traitez sa requête signée comme un secret et ne la consignez pas ou ne la mettez en cache. Le point de terminaison preview déprécié est limité à 4 MiB et vérifie la source scellée avant de retourner les octets. Les enregistrements d'activité GET sont limités au même compte et projet API. PUT /retention ne peut que raccourcir la disponibilité de la bibliothèque ; il ne peut pas étendre la rétention d'importation scellée.
Transfert vers le traitement PDF, AI Studio ou la signature#
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}]}La transmission d’une tâche ne génère aucun frais. Une transmission à l’IA impose un devis tarifé normal, le consentement à une IA externe, l’isolation du projet et l’admission par le portefeuille unique de crédits HQ. La signature ne crée qu’un brouillon : l’envoi d’une demande de test nécessite une confirmation explicite indépendante. Les documents expirés ou appartenant à autrui sont toujours refusés.
