Cacheter un PDF avec PAdES

POST /api/clickncert/v1/document/pades/sign reçoit un PDF complet en Base64 et renvoie un PDF cacheté dans une réponse JSON. Utilisez ce mode pour obtenir directement un fichier final, notamment en B-LT ou B-LTA.

Paramètres

Champ	Règle / usage
`certificate_uid`	Obligatoire ; certificat autorisé et disponible
`document_base64`	Obligatoire ; octets d’un PDF non vide encodés en Base64
`filename`	Nom métier facultatif, 255 caractères maximum
`signature_level`	`B-B` par défaut ; `B-T`, `B-LT`, `B-LTA` possibles selon offre
`digest_algorithm`	`sha256`
`certification_level`	`none` par défaut ; contrôle des modifications PDF, voir ci-dessous
`reason`	Motif facultatif, 500 caractères maximum
`location`	Lieu facultatif, 255 caractères maximum
`signature_field_name`	Nom du champ, facultatif, 128 caractères maximum
`visible_signature`	Objet facultatif pour l’apparence et le placement
`totp`	Selon le niveau et le type de certificat utilisés

L’API v1 utilise visible_signature. Le champ visible_seal appartient à l’API legacy et ne doit pas être copié dans cette requête.

Choisir le profil

Un premier test B-B permet de valider l’accès et le document. Pour dater le cachet par une source de temps de confiance, demandez B-T. B-LT incorpore aussi des éléments de validation. B-LTA ajoute une protection d’archive sur le PDF enrichi. Les profils B-T, B-LT et B-LTA nécessitent la licence API Premium.

{
  "certificate_uid": "REMPLACER_PAR_UID_CERTIFICAT",
  "document_base64": "REMPLACER_PAR_BASE64_DU_PDF",
  "filename": "attestation.pdf",
  "signature_level": "B-LT",
  "digest_algorithm": "sha256",
  "certification_level": "none",
  "reason": "Émission de l’attestation",
  "location": "France"
}

Ce modèle contient des valeurs à remplacer ; utilisez le démarrage rapide pour encoder le fichier correctement.

Restrictions de modification du PDF

`certification_level`	Intention du contrôle PDF
`none`	Pas de certification DocMDP demandée par cette option
`no_changes_allowed`	Interdire les modifications ultérieures selon les règles PDF
`form_filling`	Autoriser les usages de formulaire prévus par cette certification
`form_filling_and_annotations`	Autoriser également les annotations prévues

Cette option concerne les permissions de modification du PDF. Elle ne décrit pas la qualification eIDAS du cachet. Vérifiez sa compatibilité avec les signatures et restrictions déjà présentes ainsi qu’avec vos opérations ultérieures.

Résultat et contrôle

La réponse contient format, signature_level, filename, mime_type, signature_uid, document_base64 et metadata. Le résultat PAdES document a le type application/pdf. Décodez le Base64, conservez les octets retournés et validez le document final.

N’appliquez pas ensuite de conversion PDF, d’optimisation ou de modification de page sans analyser l’impact sur les signatures. La validation du fichier produit fait partie de la recette avec vos modèles réels.

Référence PAdES document · Apparence · Validation.