Partage et vérification

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

Les bénéficiaires 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 composer un profil public sur badges.ninja/u/<your-handle>. Voir Portail du bénéficiaire.

Page publique de l'attestation

Chaque attestation possède une URL publique :

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

Cette page affiche l'image du badge, son nom et sa description, le nom du bénéficiaire, le nom et le logo de l'émetteur, la date d'émission et l'éventuelle date d'expiration, ainsi que les critères remplis par le bénéficiaire pour obtenir le badge. Toute personne disposant du lien peut ouvrir la page pour confirmer l'authenticité de l'attestation.

La page de l'attestation affiche toujours un bouton Add to LinkedIn profile afin que le bénéficiaire puisse enregistrer l'attestation directement dans la section Licenses & Certifications de son profil LinkedIn. (Si l'émetteur a défini un identifiant d'organisation LinkedIn, LinkedIn préremplit la Page entreprise vérifiée ; sinon, il utilise le nom de l'émetteur.) Un menu déroulant Télécharger propose deux options : Image du badge (le PNG d'origine) et Certificat (un PDF A4 imprimable généré à la volée à l'adresse /certify-badge/award/{guid}/pdf).

Page publique de partage

La page de partage propose des options de partage sur les réseaux sociaux :

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

Depuis cette page, les bénéficiaires peuvent partager leur badge sur :

• LinkedIn — publie le badge dans leur fil LinkedIn (pour ajouter l'attestation directement à leur profil, utilisez plutôt le bouton Add to LinkedIn profile de la page de l'attestation)
• 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
• Envoyer un e-mail — ouvre une fenêtre intégrée qui envoie un e-mail soigné à un ou plusieurs destinataires (voir Partage par e-mail ci-dessous)
• Copier le lien — copie l'URL de vérification dans le presse-papiers
• Extraits d'intégration — copiez du HTML <img> et <iframe> prêt à coller pour placer le badge sur un site web, un intranet ou une signature d'e-mail

Vérification par QR code

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

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

Toute personne qui scanne le QR code avec l'appareil photo de son téléphone arrive sur la page de vérification en direct, où elle peut confirmer que le badge est hébergé sur badges.ninja et respecte la spécification Open Badge v2.0. L'identité du bénéficiaire est affichée sous forme de hachage SHA-256 afin que les adresses e-mail ne soient jamais exposées publiquement.

Certificat PDF

Chaque attestation peut être téléchargée sous forme de certificat PDF A4 prêt à imprimer. L'option Certificat se trouve dans le menu déroulant Télécharger de la page publique de l'attestation (/awards/{guid}) — et non sur la page de vérification, qui ne contient que le QR code scannable et le JSON Open Badge brut. Ce choix génère le PDF à la volée (à l'adresse /certify-badge/award/{guid}/pdf) avec l'image du badge, le nom du bénéficiaire, l'émetteur, les critères, la date d'émission, l'éventuelle expiration et un QR code renvoyant à 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 interroge le point de terminaison de partage et affiche une carte enrichie à partir des métadonnées Open Graph émises par badges.ninja :

• L'image du badge comme image d'aperçu
• Le nom du badge comme titre
• Le nom de l'émetteur et celui du bénéficiaire dans la description

Ainsi, les badges ont un aspect professionnel où qu'ils soient partagés — les bénéficiaires n'ont pas à joindre leur propre image ni à rédiger de texte. L'aperçu est généré côté serveur à l'adresse /certify-badge/award/{guid}/share-html et mis en cache à la périphérie du CDN, de sorte que les aperçus apparaissent instantanément, même au premier partage.

Partage par e-mail

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

Depuis la page publique de partage

Les bénéficiaires peuvent partager leur badge avec des amis, des mentors ou des employeurs potentiels en cliquant sur Envoyer un e-mail sur la page de partage. Une fenêtre s'ouvre où ils saisissent une ou plusieurs adresses e-mail, un objet facultatif et un message personnel :

Chaque destinataire reçoit un e-mail HTML soigné contenant le message personnel du bénéficiaire et un bouton pour consulter en un clic la page publique de l'attestation :

Depuis le tableau de bord

Les émetteurs peuvent envoyer n'importe quelle attestation par e-mail depuis la page Attestations du tableau de bord :

1. Repérez l'attestation sur la page Attestations.
2. Cliquez sur le bouton Envoyer de la ligne, ou ouvrez la fenêtre de détail et cliquez sur Renvoyer l'e-mail.
3. Saisissez l'adresse e-mail du bénéficiaire et envoyez.

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

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'attestation)

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

Exemple — vérifier une attestation :

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 de badge

Les images de badge sont stockées sur Amazon S3 et diffusées via notre CDN mondial sous une URL immuable adressée par le contenu, dérivée d'un hachage cryptographique (SHA-256) des octets de l'image. Cela signifie que :

• Les images sont permanentes et adressées par le contenu — l'URL est dérivée des octets eux-mêmes, elles ne peuvent donc pas être falsifiées ni remplacées en silence
• Les URL d'images dans le JSON Open Badge ressemblent à https://badges.ninja/images/{sha256}.png
• Les images sont servies depuis la périphérie du CDN : elles se chargent rapidement partout dans le monde et restent disponibles pendant toute la durée de vie de l'attestation

Comme l'image fait partie de l'assertion Open Badge, remplacer plus tard le visuel du badge n'invalide pas les attestations déjà émises : l'image d'origine conserve sa propre URL adressée par le contenu, si bien que les attestations antérieures gardent leur image d'origine même si vous redessinez le badge pour de nouvelles émissions.