Api reference
Consulter un certificat
Retourne les métadonnées complètes d'un certificat, y compris les URLs PDF et image une fois le rendu terminé.
Authorization
ApiKeyAuth AuthorizationBearer <token>
Clé API au format cm_live_..., générée depuis Paramètres > Clés API.
In: header
Path Parameters
id*string
ID du certificat
Format
uuidResponse Body
application/json
application/json
curl -X GET "http://localhost:3000/api/v1/certificates/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"recipientName": "Amadou Diallo",
"recipientEmail": "user@example.com",
"variables": {
"property1": "string",
"property2": "string"
},
"status": "GENERATED",
"renderStatus": "PENDING",
"verificationHash": "string",
"verificationUrl": "http://example.com",
"pdfUrl": "http://example.com",
"imageUrl": "http://example.com",
"template": {
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string"
},
"generatedAt": "2019-08-24T14:15:22Z",
"revokedAt": "2019-08-24T14:15:22Z",
"revokedReason": "string"
}{
"error": {
"code": "UNAUTHORIZED",
"message": "string",
"status": 0
}
}Générer un certificat
Génère un certificat à partir d'un template. Consomme **1 crédit**. Le rendu PDF est asynchrone — utilisez l'endpoint `GET /certificates/:id` ou un webhook `certificate.ready` pour savoir quand le PDF est disponible.
Télécharger le PDF
Retourne une redirection `302` vers le fichier PDF signé. Retourne `202` si le rendu n'est pas encore terminé — relancez la requête dans quelques secondes.