CertifMaker Docs

Introduction

Intégrez CertifMaker dans vos outils via l'API REST publique.

L'API CertifMaker vous permet de générer, distribuer et vérifier des certificats de formation directement depuis vos propres systèmes — LMS, outils RH, plateformes e-learning.

Base URL

https://certifmaker.com/api/v1

Fonctionnalités

  • Génération de certificats — Générez un certificat en une requête en passant les variables de votre template.
  • Génération en masse — Soumettez jusqu'à 1 000 destinataires en une seule requête via les batches.
  • Téléchargement PDF — Récupérez le PDF généré dès que le rendu est terminé.
  • Vérification publique — Vérifiez l'authenticité d'un certificat sans authentification.
  • Webhooks — Recevez des notifications HTTP en temps réel quand vos certificats sont prêts.

Modèle de crédits

Chaque appel qui génère un certificat consomme 1 crédit, qu'il provienne de l'interface ou de l'API. Les crédits s'achètent depuis le dashboard — il n'y a pas d'abonnement mensuel.

Format des réponses d'erreur

Toutes les erreurs retournent un objet structuré :

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Crédits insuffisants. Vous avez 0 crédit(s), il vous en faut 1.",
    "status": 403
  }
}

Rate limiting

Chaque réponse inclut les headers suivants :

HeaderDescription
X-RateLimit-LimitNombre maximum de requêtes par fenêtre
X-RateLimit-RemainingRequêtes restantes dans la fenêtre courante
X-RateLimit-ResetTimestamp UNIX de la prochaine réinitialisation

En cas de dépassement, la réponse retourne 429 avec un header Retry-After.

On this page