CertifMaker Docs
Api reference

Consulter un template

Retourne les détails d'un template, y compris ses variables détectées, le nom de formation et le paramètre de nom du destinataire.

GET
/templates/{id}

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 template

Formatuuid

Response Body

application/json

application/json

curl -X GET "http://localhost:3000/api/v1/templates/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "certificat_completition",
  "formationName": "Formation Marketing Digital 2025",
  "description": "string",
  "type": "PRIVATE",
  "detectedVariables": [
    "nom_complet",
    "formation",
    "date_fin"
  ],
  "recipientNameVariable": "nom_complet",
  "thumbnailUrl": "http://example.com",
  "timesUsed": 0,
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "string",
    "status": 0
  }
}

Lister les templates

Retourne vos templates privés et les templates publics partagés, avec les variables détectées pour chacun.

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.