Logo PDFHQ

Documents

DocumentationOpérations PDF

API de signature de PDF (marques visibles)

Placez un nom dactylographié, une date ou une image de signature dessinée sur un PDF en utilisant le cycle de vie de la tâche mesurée. Cela ne vérifie pas les identités ni n'émet de signatures cryptographiques soutenues par certificat.

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

Sémantique du point de terminaison et de la tâche#

Code d'opération : sign

Commencez cette opération avec POST /v1/tasks et le code d'outil affiché ci-dessus. Importez et joignez les PDF source (ou utilisez les points de terminaison d'importation limités à la tâche), puis appelez POST /v1/tasks/{task_id}/process avec les paramètres d'opération.

Ajoutez une signature visible examinée, des initiales ou une date aux documents avec la permission du signataire.

Entrées : Exactement un PDF scellé ; 1–12 marques ; maximum 100 Mio et 500 pages (les limites du plan peuvent être inférieures). Les documents contenant déjà des signatures numériques sont rejetés.

Configuration et paramètres supplémentaires#

ParamètreTapezComportement
marksobligatoire object[]1–12 marques ; chacune inclut la page (basée sur 1), x0, y0, x1, y1 en points PDF en haut à gauche et kind : typed, date ou drawn. Les marques typées/date incluent du texte ; les marques dessinées incluent des octets PNG en base64 (sans préfixe URL de données). Images max 96 Kio, 1600 × 600 pixels.

Les options sont validées par l'API. Les paramètres inconnus et les valeurs non prises en charge retournent une erreur au lieu d'être ignorés.

Séquence de demande en cours#

Programming language: cURL

Choisir une langue · faites défiler horizontalement pour les 10 langages SDK

API example · cURL
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"tool":"sign"}'

# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'

# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"marks":[{"kind":"typed","page":1,"x0":72,"y0":650,"x1":320,"y1":715,"text":"Jane Doe"}]}}'

curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'

After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.

All 10 SDKs ↓Procédure complète Python ↓ Procédure complète Bash/cURL ↓ Tous les points de terminaison → Importations directes → Gestion des erreurs →

Les packages téléchargeables générés couvrent uniquement le flux de travail des tâches. Les SDK de service complet nécessitent une spécification OpenAPI de runtime vérifiée ; les SDK de tâches Python, JavaScript et TypeScript diffusent les importations de fichiers ; les autres langues nécessitent des importations multipart signées implémentées par l'appelant.

L'ID de tâche retourné est utilisé à la fois pour l'interrogation du statut et la récupération. Une fois la tâche réussie, demandez une URL de sortie signée plutôt que d'intégrer un secret de téléchargement.

Résultat et détails importants#

Nouveau PDF contenant des marques de signature visibles dans les rectangles demandés. Les pages source et le texte original restent accessibles.

Cette opération ne crée PAS de certificat numérique, de piste d'audit du destinataire, d'attestation de conformité légale ou de vérification d'identité du signataire. Les signatures numériques PDF existantes sont rejetées ; les pages cibles pivotées ne sont pas prises en charge. Pour les flux de travail de signature de destinataire de qualité professionnelle, intégrez un fournisseur dédié.

Erreurs, tentatives et facturation
Logo PDFHQ

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

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