Apparence et placement du cachet PDF
Configurer une représentation visible sans confondre image et preuve cryptographique.
Un cachet peut être cryptographiquement valide sans représentation visible sur la page. L’apparence sert à informer le lecteur ; elle ne remplace pas le contrôle de signature du PDF.
Objet v1 visible_signature
visible_signature{
"enabled": true,
"type": "box",
"page": -1,
"x": 36,
"y": 36,
"width": 180,
"height": 60,
"signing_reason": "Document émis par l’organisation",
"logo_opacity": 0.3
}Ajoutez cet objet sous la clé visible_signature d’une requête PAdES document v1. Il ne s’agit pas d’un endpoint autonome.
Coordonnées et dimensions
| Paramètre | Règle |
|---|---|
enabled | Active l’apparence ; absent ou faux : pas d’apparence visible demandée |
type | box ou inline |
page | Numéro à partir de 1 ; -1 désigne la dernière page |
x, y | Coordonnées en points PDF, depuis l’origine inférieure gauche ; valeurs positives ou nulles |
width, height | Dimensions en points, au moins 1 ; rectangle contenu dans la page |
logo | Image PNG/JPEG encodée en Base64, facultative |
signing_reason | Texte visible facultatif, 100 caractères maximum |
logo_opacity | Nombre entre 0 et 1 |
Une unité PDF usuelle vaut 1/72 de pouce. Les pages recadrées ou tournées nécessitent une recette visuelle avec le document réel. Le moteur vérifie que le rectangle tient dans les limites de la page ; une géométrie invalide est refusée.
Les valeurs par défaut du placement sont page 1, x=36, y=36, largeur 180 et hauteur 60. Pour un rendu inline, les dimensions omises peuvent suivre les dimensions propres à ce style ; transmettez des valeurs explicites si votre modèle dépend d’un placement précis.
Logo et contenu visible
Le logo personnalisé et le logo d’abonnement sont exploités selon le style de rendu. Le style box permet notamment la personnalisation par logo et texte. L’API limite la longueur du champ Base64 du logo à 2 097 152 caractères ; ce nombre n’est pas une garantie de taille binaire après décodage.
Préparez une image lisible et légère, sans informations sensibles inutiles. Contrôlez le contraste et le chevauchement avec le texte du document. N’utilisez pas l’apparence comme seule indication de validité dans votre interface.
Compatibilité legacy
L’ancienne API multipart utilise visible_seal et impose d’autres règles : x, y, page et type sont requis lorsqu’un objet de placement est fourni ; largeur et hauteur ont des bornes spécifiques. Les noms des niveaux de certification PDF diffèrent aussi. Correspondance complète.
Updated about 1 hour ago