Intégrations (Zapier, Make et plus)

Connectez badges.ninja aux outils que vous utilisez déjà — émettez des credentials automatiquement lorsqu'un événement survient ailleurs, et réagissez en temps réel lorsqu'un credential est émis, délivré, révoqué ou consulté. Toute plateforme qui parle REST et webhooks fonctionne ; Zapier et Make sont les plus rapides.

Ce que vous pouvez automatiser

Déclencheurs (badges.ninja → vos outils) — lancez un workflow lorsque :

• un credential est émis
• un credential est délivré (son e-mail est envoyé)
• un credential est révoqué
• un credential est consulté pour la première fois

Actions (vos outils → badges.ninja) :

• émettre un credential — attribuer un badge à un destinataire

Prérequis

1. Créez une clé API dans le tableau de bord sous Clés API. Utilisez une clé en lecture-écriture pour les actions (émission) ; une clé en lecture seule suffit pour les déclencheurs uniquement. Voir Clés API.
2. C'est tout — tout passe par l'API REST et les webhooks.

Zapier

Une fois l'application Zapier badges.ninja connectée :

1. Connectez votre compte — collez votre clé API lorsque vous y êtes invité.
2. Choisissez un déclencheur (par ex. Credential Issued) ou l'action Issue Credential.
3. Mappez les champs et activez le Zap.

En coulisses, les déclencheurs utilisent le modèle REST Hook de Zapier, appuyé sur l'API Webhooks : Zapier s'abonne via POST /webhooks et badges.ninja lui délivre les événements en temps réel, sans délai d'interrogation.

Make (Integromat) et plateformes personnalisées

Aucune application requise — connectez-le directement :

1. Authentifiez-vous avec l'en-tête X-Api-Key sur chaque requête.
2. Abonnez-vous aux événements en enregistrant votre point de terminaison :

   curl -X POST https://api.badges.ninja/webhooks \
     -H "X-Api-Key: bws_your_api_key_here" \
     -H "Content-Type: application/json" \
     -d '{ "url": "https://hook.example.com/badges", "events": ["credential.issued"] }'

3. Recevez les livraisons signées à votre point de terminaison. Vérifiez l'en-tête X-Bws-Signature — voir Webhooks.
4. Émettez des credentials en appelant POST /awards — voir API Awards.

Référence

• API Webhooks — événements, charges utiles, signatures, nouvelles tentatives
• API Awards — émission de credentials
• Clés API — clés et scopes d'accès

Le code source de l'application Zapier se trouve dans le dépôt sous integrations/zapier/ et peut être publié avec la CLI Zapier.