Micro-Certif
Attribuez vos badges Open Badges 3.0 directement depuis votre site, votre plateforme de formation ou votre outil métier, sans ressaisie et sans quitter votre environnement.
L’API de Micro-Certif relie votre site à votre compte émetteur. Lorsqu’une personne a rempli vos conditions (formation terminée, dossier validé par un jury, projet réussi…), votre site demande à Micro-Certif d’émettre le badge. Micro-Certif génère le badge signé, prévient le bénéficiaire par e-mail et recueille son accord.
L’API suit les principes REST, répond en JSON et fonctionne de serveur à serveur : c’est votre serveur qui dialogue avec Micro-Certif, jamais le navigateur de vos visiteurs. Vos identifiants ne sont donc jamais exposés dans une page web.
Un simple appel avec le prénom, le nom et l’e-mail du bénéficiaire suffit. S’il n’existe pas encore dans votre compte, il est créé automatiquement.
Chaque attribution déclenche un e-mail d’acceptation. Le badge ne devient officiel qu’une fois accepté ; vous pouvez renvoyer l’e-mail à tout moment.
Votre site interroge l’API pour savoir si un badge est en attente, accepté ou refusé, et l’affiche dans vos propres tableaux de bord.
Vous indiquez la date d’attribution et, si vous le souhaitez, une date d’expiration. Un badge expiré ou refusé peut être attribué à nouveau.
Si la personne détient déjà le badge en cours de validité, l’API renvoie l’attribution existante sans en créer une seconde. Un appel relancé après une coupure réseau est sans risque.
Chaque intégration possède sa clé et son secret. Les échanges se font uniquement en HTTPS, les appels sont journalisés, et une intégration peut être coupée immédiatement.
La création et la mise en forme des badges (titre, image, critères) se font dans votre espace Micro-Certif. L’API sert à les attribuer et à en suivre l’état. Une fois vos badges créés et paramétrés sur votre compte "Emetteur", vous n'avez quasiment plus à vous connecter sur Micro-Certif : tout se passe directement sur votre site !
mc_pub_…) et une clé secrète (mc_secret_…).GET /me pour contrôler vos identifiants, puis attribuez
un badge à votre propre adresse e-mail pour dérouler tout le parcours.La clé secrète ne doit jamais apparaître dans une page web, dans du JavaScript ou dans un dépôt de code public. En cas de doute, demandez-nous de le régénérer : l’ancien cesse aussitôt de fonctionner.
Adresse de base : https://micro-certif.com/api/v1 (HTTPS obligatoire).
Chaque requête porte deux en-têtes :
X-MC-Key: mc_pub_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
X-MC-Secret: mc_secret_xxxxxxxxxxxxxxxxxxxxxxxx
| Méthode | Chemin | Rôle |
|---|---|---|
| GET | /me | Vérifie les identifiants et renvoie l’état du compte (abonnement, bénéficiaires restants) |
| GET | /badges | Liste des badges que vous pouvez attribuer |
| POST | /attributions | Attribue un badge à une personne |
| GET | /attributions/{id} | État d’une attribution |
| POST | /attributions/{id}/renvoyer | Renvoie l’e-mail d’acceptation (l’ancien lien est annulé) |
| Champ | Obligatoire | Format |
|---|---|---|
badge_id | oui | Numéro du badge |
prenom, nom | oui | Texte, 100 caractères au plus |
email | oui | Adresse e-mail du bénéficiaire |
date_attribution | non | AAAA-MM-JJ (par défaut : aujourd’hui) |
date_expiration | non | AAAA-MM-JJ |
evidence_note | non | Justification inscrite dans le badge, 2000 caractères au plus |
evidence_url | non | Adresse web d’une preuve |
pays | non | Texte |
Exemple avec cURL
curl -X POST https://micro-certif.com/api/v1/attributions \
-H "X-MC-Key: mc_pub_…" \
-H "X-MC-Secret: mc_secret_…" \
-H "Content-Type: application/json" \
-d '{
"badge_id": 7,
"prenom": "Julie",
"nom": "Martin",
"email": "julie.martin@exemple.fr",
"date_expiration": "2029-10-03"
}'
Exemple avec le client PHP fourni
$mc = new MicroCertifClient('https://micro-certif.com/api/v1', MC_API_KEY, MC_API_SECRET);
$r = $mc->attribuer([
'badge_id' => 7,
'prenom' => 'Julie',
'nom' => 'Martin',
'email' => 'julie.martin@exemple.fr',
]);
if ($r['ok']) {
$id = $r['data']['attribution']['id']; // à conserver pour le suivi
} else {
echo $r['message']; // $r['code'] : code d'erreur stable
}
Toutes les réponses sont en JSON, sous la même forme :
{ "success": true,
"data": {
"attribution": {
"id": 1542,
"statut": "en_attente",
"badge_id": 7,
"badge_nom": "Nom du badge",
"badge_image_url": "https://micro-certif.com/…",
"date_attribution": "2026-10-03",
"date_expiration": "2029-10-03",
"expire": false,
"date_reponse": null,
"credential_url": "https://micro-certif.com/…",
"email_envoye": true
},
"deja_attribue": false
}
}
{ "success": false,
"error": { "code": "SUBSCRIPTION_EXPIRED", "message": "L'abonnement Micro-Certif de ce compte a expiré." }
}
Le champ statut vaut en_attente, accepte ou refuse.
Une création renvoie le code HTTP 201 ; si le badge était déjà attribué, la réponse est 200 avec
deja_attribue: true.
| Code | HTTP | Signification |
|---|---|---|
UNAUTHORIZED | 401 | Clé ou secret absent ou invalide |
INTEGRATION_DISABLED | 403 | Intégration désactivée |
SUBSCRIPTION_EXPIRED | 403 | Abonnement expiré |
BENEFICIARY_QUOTA_REACHED | 403 | Nombre de bénéficiaires de l’abonnement atteint |
BADGE_NOT_ALLOWED | 403 | Le badge n’appartient pas à votre compte |
BADGE_INACTIVE | 409 | Badge désactivé dans votre espace |
VALIDATION_ERROR | 422 | Champ manquant ou mal formé |
NOT_FOUND | 404 | Attribution inconnue |
ALREADY_ANSWERED | 409 | Renvoi d’e-mail alors que le bénéficiaire a déjà répondu |
TOO_MANY_REQUESTS | 429 | Trop de requêtes : réessayez dans une minute |
SERVER_ERROR | 500 | Erreur interne : réessayez plus tard |
id d’attribution renvoyé : il sert à tous les appels de suivi.Micro-Certif propose un service de développement de modules de badgeage 100 % personnalisés, connectés à votre site. Nous concevons le module autour de votre fonctionnement, pas l’inverse.
Le module s’installe dans vos pages existantes : bouton d’attribution au bon endroit, respect de vos rôles et de vos étapes de validation.
Page publique de présentation du badge et certificat imprimable, avec votre logo et votre charte graphique.
Tableau de suivi des personnes et des badges reçus, échéances de validité, exports et statistiques pour vos administrateurs.
Étude de votre besoin, développement, mise en service et accompagnement jusqu’au premier badge émis.
Chaque projet fait l’objet d’un devis. Contactez-nous en décrivant votre site et ce que vous souhaitez certifier.
Créez d'abord votre compte Émetteur, sélectionnez votre abonnement et configurez vos badges associés à votre compte. Contactez-nous ensuite pour vous ouvrir l'accès à notre API et vous transmettre vos clés.
Notre équipe peut accompagner votre développeur jusqu’au premier badge émis. Vous n'avez pas de ressources internes pour votre développement ? Nous développons directement votre interface de badgeage 100% personnalisée
(voir notre offre ci-dessus).