Clé API Carte de communauté

À quoi sert cette API ?

Cette API permet de générer des liens uniques pour distribuer des badges à des utilisateurs spécifiques. Chaque lien généré peut être personnalisé avec une adresse e-mail et une note optionnelle.
Elle offre :

Liens uniques : génération de liens de réclamation personnalisés pour la distribution de badges
Ciblage par e-mail : association optionnelle des liens à des e-mails utilisateur spécifiques
Intégration flexible : API REST simple avec génération de liens instantanée

Générer votre clé API

Rendez-vous dans l'onglet Configuration API de la Carte de communauté.
Cliquez sur Générer la clé API.
Votre clé s'affiche dans le champ Votre clé API, avec le statut Actif.
- Utilisez l'icône œil pour l'afficher en clair.
- Utilisez l'icône de copie pour la copier dans le presse-papier.

⚠️ Conservez votre clé API en sécurité. Ne la partagez pas publiquement et ne l'enregistrez pas dans un dépôt de code.

Comment utiliser l'API

Point de terminaison

POST https://badgebot.mydid.com/api/v1/auth/sessions/builders/create

Exemple de requête

curl -X POST https://badgebot.mydid.com/api/v1/auth/sessions/builders/create \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "email": "user@example.com",
    "note": "Welcome bonus badge"
  }'

Exemple de réponse

{
  "links": [
    "https://mydid.page.link/iHu1WKFuPHADvEaH9"
  ]
}

Documentation complète

Pour la référence API complète, les détails d'authentification et des exemples d'utilisation avancés, consultez la documentation technique dédiée : 👉 https://swagger.mydid.com/

Mis à jour le : 10/07/2026

Cet article a-t-il répondu à vos questions ?

Merci !