Référence des endpoints Click&Cert
Retrouver les huit routes v1, les résultats et les paramètres communs.
Base de production documentée : https://my.datasure.net. Les endpoints métier utilisent HTTP Basic sur HTTPS, un abonnement Click&Cert actif et un certificat autorisé pour l’utilisateur.
Routes v1
Toutes les opérations suivantes sont des POST JSON. Les quatre routes document utilisent document_base64, les quatre routes digest utilisent digest_base64.
| Format | Document complet | Empreinte | Droit commercial |
|---|---|---|---|
| PAdES | /api/clickncert/v1/document/pades/sign | /api/clickncert/v1/digest/pades/sign | Document B-B standard ; profils horodatés et digest Premium |
| XAdES | /api/clickncert/v1/document/xades/sign | /api/clickncert/v1/digest/xades/sign | Premium |
| CAdES | /api/clickncert/v1/document/cades/sign | /api/clickncert/v1/digest/cades/sign | Premium |
| JAdES | /api/clickncert/v1/document/jades/sign | /api/clickncert/v1/digest/jades/sign | Inclusion et activation à préciser dans l’offre |
La présence d’un endpoint ne garantit ni l’ouverture sur chaque environnement ni son inclusion dans votre abonnement. Voir la matrice de licence et les profils supportés.
Paramètres communs
| Champ | Règle |
|---|---|
certificate_uid | Obligatoire ; identifiant du certificat |
document_base64 | Obligatoire en mode document ; contenu non vide |
digest_base64 | Obligatoire en mode digest ; longueur cohérente avec l’algorithme |
filename | Facultatif en mode document ; l’une des deux références requise en mode digest |
reference_uri | Selon format ; alternative à filename en mode digest |
signature_level | B-B par défaut ; valeurs selon format et mode |
digest_algorithm | sha256 par défaut ; SHA-384/SHA-512 disponibles en XAdES |
totp | Code à six chiffres selon certificat |
L’API ne publie pas un plafond universel de taille pour tous les documents v1. Le Base64 augmente la taille de transport d’environ un tiers, avant l’enveloppe JSON. Les plafonds d’infrastructure et ceux convenus pour votre environnement s’appliquent.
Réponse commune réussie
| Champ | Signification |
|---|---|
format | pades, xades, cades ou jades |
signature_level | Profil produit |
filename | Nom du résultat |
mime_type | Type de contenu du résultat décodé |
signature_uid | UUID de l’opération de signature |
document_base64 | Document ou conteneur de signature encodé en Base64 |
metadata | Informations dépendantes du format et du profil |
Cette réponse n’a pas d’enveloppe data. Les métadonnées peuvent inclure le packaging, les algorithmes, la présence d’horodatage, les références et les nombres d’éléments de validation. Ne supposez pas que chaque clé existe pour tous les formats. signature_uid est une référence de suivi ; il n’est pas documenté comme une route de téléchargement ou une clé d’idempotence.
Référence interactive
La consultation du certificat public et les anciennes routes sont décrites dans Certificats et Compatibilité legacy. Les fonctions internes d’administration d’abonnement et de certificat ne sont pas des API métier de cachet pour les intégrateurs.
Updated about 2 hours ago