Partage et vérification

Chaque attribution sur badges.ninja dispose d'une page de vérification publique accessible à tous sans connexion. Les destinataires peuvent partager leurs badges sur les réseaux sociaux, par e-mail ou en copiant un lien direct.

Les destinataires ont aussi leur propre portail

Si vous avez obtenu un badge via badges.ninja, vous pouvez vous connecter (sans mot de passe) sur badges.ninja/me pour voir tous vos badges au même endroit et créer un profil public à badges.ninja/u/<votre-identifiant>. Voir Portail du destinataire.

Page publique d'attribution

Chaque attribution dispose d'une URL publique :

https://badges.ninja/awards/{guid}

Cette page affiche l'image du badge (chargée depuis IPFS), le nom et la description du badge, le nom du destinataire, le nom et le logo de l'émetteur, la date d'émission et la date d'expiration éventuelle, ainsi que les critères que le destinataire a remplis pour obtenir le badge. Toute personne disposant du lien peut ouvrir la page pour confirmer l'authenticité du justificatif.

Si l'émetteur a défini un identifiant d'organisation LinkedIn, le bouton Ajouter au profil LinkedIn apparaît afin que le destinataire puisse enregistrer le justificatif directement dans ses Licences et certifications LinkedIn. Le bouton Télécharger le badge sert l'image originale du badge (directement depuis IPFS), et Télécharger le PDF génère à la volée un certificat A4 imprimable.

Page publique de partage

La page de partage propose des options de partage social :

https://badges.ninja/awards/{guid}/share

Depuis cette page, les destinataires peuvent partager leur badge sur :

• LinkedIn — publie sur leur fil LinkedIn ou ajoute le justificatif directement à leur profil via le bouton Add to LinkedIn Profile (lorsque l'émetteur a défini un identifiant d'organisation LinkedIn)
• Twitter / X — publie un tweet avec le lien du badge et un texte de partage personnalisé
• Facebook — partage sur leur journal Facebook
• WhatsApp — envoie un message avec le lien du badge
• Telegram — envoie un message avec le lien du badge
• Send Email — ouvre une fenêtre modale dans la page qui envoie un e-mail stylisé à un ou plusieurs destinataires (voir Partage par e-mail ci-dessous)
• Copy Link — copie l'URL de vérification dans le presse-papiers
• Embed snippets — copie du HTML <img> et <iframe> prêt à coller pour intégrer le badge dans un site web, un intranet ou une signature d'e-mail

Vérification par QR

Une page de vérification dédiée affiche un code QR scannable pointant vers sa propre URL — parfait pour les certificats imprimés, les bannières d'événements ou les captures d'écran LinkedIn.

https://badges.ninja/verify/{guid}

Quiconque scanne le QR avec l'appareil photo de son téléphone arrive sur la page de vérification en direct, où il peut confirmer que le badge est hébergé sur badges.ninja, qu'il respecte la spécification Open Badge v2.0 et (sur le plan Pro) qu'il est ancré sur la chaîne via Matchain. L'identité du destinataire est affichée sous forme de hachage SHA-256 afin que les e-mails ne soient jamais exposés publiquement.

Certificat PDF

Chaque attribution dispose d'un bouton Télécharger le certificat sur la page publique de vérification. Cliquer dessus génère à la volée un PDF A4 prêt à imprimer comprenant l'image du badge, le nom du destinataire, l'émetteur, les critères, la date d'émission, l'expiration optionnelle et un code QR renvoyant vers l'URL de vérification en direct.

Aperçus sur les réseaux sociaux

Lorsqu'un lien de badge est partagé sur LinkedIn, X, Slack, Facebook, WhatsApp ou par e-mail, la plateforme récupère le point de terminaison de partage et affiche une carte enrichie à partir des métadonnées Open Graph que badges.ninja émet :

• Image du badge en image d'aperçu
• Nom du badge en titre
• Nom de l'émetteur et nom du destinataire dans la description

Cela garantit que les badges semblent professionnels lorsqu'ils sont partagés où que ce soit — les destinataires n'ont pas à joindre leur propre image ou à rédiger du texte. L'aperçu est généré côté serveur à /certify-badge/award/{guid}/share-html et mis en cache sur la périphérie du CDN, de sorte que les aperçus apparaissent instantanément même lors du premier partage.

Partage par e-mail

Vous pouvez envoyer des attributions de badges par e-mail de deux façons :

Depuis la page publique de partage

Les destinataires peuvent partager leur badge avec des amis, mentors ou employeurs potentiels en cliquant sur Send Email sur la page de partage. Une fenêtre modale s'ouvre dans laquelle ils saisissent une ou plusieurs adresses e-mail, un objet facultatif et un message personnel :

Chaque destinataire reçoit un e-mail HTML stylisé contenant le message personnel du destinataire et un bouton en un clic pour consulter la page publique d'attribution :

Depuis le tableau de bord

Les émetteurs peuvent envoyer toute attribution par e-mail depuis la page Attributions du tableau de bord :

1. Trouvez l'attribution sur la page Attributions.
2. Cliquez sur le bouton Send sur la ligne, ou ouvrez la modale de détail et cliquez sur Resend email.
3. Saisissez l'e-mail du destinataire et envoyez.

Le même modèle d'e-mail est utilisé pour les deux flux.

Points de terminaison JSON Open Badge v2.0

Pour assurer l'interopérabilité avec d'autres plateformes de badges, badges.ninja fournit du JSON Open Badge v2.0 standard à ces points de terminaison publics :

Point de terminaison	Description
/certify-badge/issuer/{guid}	JSON du profil de l'émetteur
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (l'attribution)

Ces points de terminaison renvoient du JSON-LD conforme à la spécification Open Badge v2.0. D'autres plateformes de badges et vérificateurs peuvent consommer ces données pour valider les justificatifs.

Exemple — vérifier une attribution :

curl https://api.badges.ninja/certify-badge/award/abc123-def456

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "Assertion",
  "id": "https://api.badges.ninja/certify-badge/award/abc123-def456",
  "recipient": {
    "type": "email",
    "identity": "sha256$..."
  },
  "badge": "https://api.badges.ninja/certify-badge/badge/xyz789",
  "issuedOn": "2025-01-15T00:00:00.000Z",
  "verification": {
    "type": "hosted"
  }
}

URL des images IPFS

Les images des badges sont épinglées sur IPFS (l'InterPlanetary File System) via notre propre passerelle, ipfs.ninja. Cela signifie :

• Les images sont permanentes et adressées par contenu — elles ne peuvent pas être altérées ni remplacées silencieusement
• Les URL des images dans le JSON Open Badge ressemblent à https://ipfs.ninja/ipfs/{cid}
• Le même identifiant de contenu se résout via toute passerelle IPFS publique (cloudflare-ipfs.com, ipfs.io, etc.) — vos badges ne sont pas verrouillés à un seul fournisseur

Comme l'image fait partie de l'assertion Open Badge, remplacer ultérieurement le visuel du badge ne casse pas les attributions précédemment émises : l'ancien CID IPFS reste résolvable pour toujours, donc les attributions historiques conservent leur image originale même si vous redessinez le badge pour les nouvelles émissions.