Compatibilité avec les anciennes API Click&Cert
Distinguer les entrées multipart, la signature RSA brute et les contrats v1.
Les routes historiques restent décrites dans la référence. Pour une nouvelle intégration nécessitant des profils explicites ou des conteneurs normalisés, choisissez les routes v1 lorsque votre environnement les propose. Une migration doit vérifier le contrat d’entrée et de sortie ; un simple remplacement d’URL ne suffit pas.
Routes historiques
| Méthode et chemin | Entrée | Résultat |
|---|---|---|
POST /api/clickncert/pdf/new | Multipart : certificate_uid, pdf, options | PDF binaire |
POST /api/clickncert/new | Alias de l’opération PDF | PDF binaire |
POST /api/clickncert/hash/new | certificate_uid, hash SHA-256 hexadécimal | JSON avec signature RSA PKCS#1 Base64 |
POST /api/clickncert/file/new | Multipart : certificate_uid, file | JSON avec signature RSA PKCS#1 Base64 |
Les routes hash et file ne renvoient pas de conteneur CAdES. Le champ verification: "OK" de leur réponse correspond au contrôle effectué lors du traitement ; il ne remplace pas une validation de confiance du document dans votre système.
Différences avec v1
| Élément | Legacy PDF | v1 PAdES document |
|---|---|---|
| Transport du PDF | Fichier multipart pdf | JSON document_base64 |
| Résultat | PDF binaire | JSON avec PDF Base64 |
| Profil | Non sélectionné par signature_level dans ce contrat | B-B, B-T, B-LT, B-LTA explicites |
| Apparence | visible_seal | visible_signature avec enabled |
| Permissions PDF | Noms CERTIFICATION_LEVEL_* | Valeurs none, no_changes_allowed, form_filling, form_filling_and_annotations |
| Disposition de réponse | response_content_disposition: inline ou attachment | Enveloppe JSON à décoder |
Le traitement PDF historique ajoute un horodatage. Son comportement ne permet pas de déduire que l’horodatage est inclus dans une licence standard actuelle : vérifiez le périmètre commercial de votre contrat avant usage ou migration.
Apparence legacy
visible_seal peut être transmis comme objet de formulaire ou chaîne JSON. Lorsqu’il est présent, renseignez x, y, page et type. La page vaut -1 pour la dernière page ou un entier à partir de 1. Les styles sont box et inline.
La largeur facultative est bornée entre 50 et 600 ; la hauteur entre 20 et 200. Les options comprennent logo, signing_reason et logo_opacity. Les règles et valeurs par défaut de v1 ne doivent pas être transposées sans vérification.
Signature brute
La réponse hash comprend notamment certificate_uid, hash, algorithm OID, signature et verification. L’API file ajoute le nom du fichier. hash est hexadécimal ; signature est Base64. Le champ algorithm OID contient un espace dans son nom : utilisez l’accès par clé exact de votre langage.
La signature brute est une brique de construction cryptographique. Pour XAdES, CAdES ou PAdES, préférez une route créant le conteneur attendu. La licence API Premium reste requise pour la signature de hash.
Updated about 2 hours ago