Logo PDFHQ

Documents

DocumentationMise en route

Importations directes de PDF

Importations de stockage présignées sécurisées, sommes de contrôle SHA-256, achèvement et expiration de l'importation.

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

Bibliothèque de documents#

Après avoir scellé un import, enregistrez son upload_id et son titre avec POST /v1/workspace/documents. La bibliothèque stocke une référence scoped au compte et à la clé API, sans copier le fichier ni prolonger son expiration d'origine.

Lister, renommer et supprimer les références sous /v1/workspace/documents. Les points de terminaison d'aperçu et d'activité revérifient la propriété et l'expiration. PUT / {document_id}/retention accepte un horodatage retained_until qui ne peut que raccourcir la disponibilité. La suppression d'une référence laisse le téléchargement d'origine sous sa politique de rétention existante.

POST /{document_id}/handoff/task attache la source à une tâche ; /handoff/ai nécessite le devis normal, le consentement explicite de l'IA externe et la clé d'idempotence ; /handoff/signing crée un brouillon pour révision et envoi séparés. OAuth nécessite files.read ou files.write pour les opérations de bibliothèque, jobs.write pour le transfert de tâches, ai.write pour le transfert d'IA et signatures.write pour le transfert de signature.

Admission de fichier#

Demander un téléversement présigné en utilisant POST /v1/documents/uploads avec nom de fichier, content_type=application/pdf, size_bytes et le SHA-256 minuscule des octets source exacts. La réponse contient une URL POST S3 et des champs de formulaire multipart signés.

Renvoyez tous les champs retournés sans modification et le fichier vers l'URL S3. Appelez ensuite POST /v1/documents/uploads/{upload_id}/complete pour vérifier la taille et les métadonnées et sceller l'objet. Seuls les importations prêtes peuvent être jointes aux tâches. Préférez POST /v1/tasks/{task_id}/uploads et le lien d'achèvement renvoyé pour joindre automatiquement le fichier.

cURL
curl -X POST https://api.pdfhq.io/v1/documents/uploads \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"filename":"report.pdf","content_type":"application/pdf","size_bytes":12345,"sha256":"ACTUAL_64_CHAR_DIGEST"}'

Confidentialité et limites#

Un import de tâche ne peut être joint qu'à une seule tâche. Les tickets d'import expirent ; la taille, la signature PDF et le résumé doivent correspondre. Ne conservez pas les URL signées et ne consignez pas le contenu de fichier sensible. Les clients peuvent supprimer les imports inutilisés avant leur soumission à une tâche.

Logo PDFHQ

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

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