Logo PDFHQ

Documents

DocumentationDocuments et intelligence

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.

Clés API côté serveur Importations de stockage signées

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.

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

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

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

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}]}

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.

Logo PDFHQ

Outils PDF et intelligence documentaire. Préparez, comprenez et travaillez avec vos documents.

© 2026 PDFHQ. Tous droits réservés.