Démarrage rapide
Générez votre premier certificat via l'API en moins de 5 minutes.
1. Créer une clé API
Depuis le dashboard, allez dans Paramètres → Clés API et créez une nouvelle clé avec le scope certificates:write. Copiez le secret — il ne sera affiché qu'une seule fois.
2. Récupérer l'ID de votre template
Listez vos templates pour trouver l'id à utiliser :
curl https://certifmaker.com/api/v1/templates \
-H "Authorization: Bearer cm_live_VOTRE_CLE"{
"templates": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Certificat de formation",
"detectedVariables": ["nom_complet", "formation", "date_fin"]
}
]
}3. Générer un certificat
curl -X POST https://certifmaker.com/api/v1/certificates \
-H "Authorization: Bearer cm_live_VOTRE_CLE" \
-H "Content-Type: application/json" \
-d '{
"templateId": "550e8400-e29b-41d4-a716-446655440000",
"variables": {
"nom_complet": "Amadou Diallo",
"formation": "Gestion de projet",
"date_fin": "31 mars 2026"
},
"recipientEmail": "amadou.diallo@example.com",
"sendEmail": true
}'{
"id": "cert_abc123",
"verificationHash": "a1b2c3d4e5f6...",
"verificationUrl": "https://certifmaker.com/verify/a1b2c3d4e5f6",
"renderStatus": "PENDING",
"credits": { "consumed": 1, "remaining": 49 }
}4. Attendre le rendu
Le rendu est asynchrone. Vous pouvez soit :
Option A — Configurer un webhook (recommandé) pour recevoir une notification certificate.ready dès que le PDF est prêt.
Option B — Poller le statut jusqu'à renderStatus: "COMPLETED" :
curl https://certifmaker.com/api/v1/certificates/cert_abc123 \
-H "Authorization: Bearer cm_live_VOTRE_CLE"5. Télécharger le PDF
curl -L https://certifmaker.com/api/v1/certificates/cert_abc123/download \
-H "Authorization: Bearer cm_live_VOTRE_CLE" \
-o certificat.pdfLe -L suit la redirection vers le fichier en storage.