Compartició i verificació

Cada premi a badges.ninja té una pàgina pública de verificació a la qual qualsevol pot accedir sense iniciar sessió. Els destinataris poden compartir les seves insígnies a les xarxes socials, per correu electrònic o copiant un enllaç directe.

Els destinataris també tenen el seu propi portal

Si has guanyat una insígnia mitjançant badges.ninja, pots iniciar sessió (sense contrasenya) a badges.ninja/me per veure totes les teves insígnies en un sol lloc i crear un perfil públic a badges.ninja/u/<el-teu-handle>. Consulta Portal del destinatari.

Pàgina pública del premi

Cada premi té una URL pública:

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

Aquesta pàgina mostra la imatge de la insígnia (carregada des d'IPFS), el nom i la descripció de la insígnia, el nom del destinatari, el nom i el logotip de l'emissor, la data d'emissió i qualsevol data de caducitat, i els criteris que el destinatari ha complert per guanyar la insígnia. Qualsevol persona amb l'enllaç pot obrir la pàgina per confirmar que la credencial és autèntica.

Si l'emissor ha definit un LinkedIn organization ID, apareix el botó Add to LinkedIn profile perquè el destinatari pugui guardar la credencial directament a la seva secció LinkedIn Licenses & Certifications. El botó Download Badge serveix la imatge original de la insígnia (directament des d'IPFS), i Download PDF genera al moment un certificat A4 imprimible.

Pàgina pública per compartir

La pàgina per compartir ofereix opcions de compartició social:

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

Des d'aquesta pàgina, els destinataris poden compartir la seva insígnia a:

• LinkedIn — publica al seu feed de LinkedIn, o afegeix la credencial directament al seu perfil mitjançant el botó Add to LinkedIn Profile (quan l'emissor ha definit un LinkedIn organization ID)
• Twitter / X — publica un tuit amb l'enllaç de la insígnia i un text de compartició personalitzat
• Facebook — comparteix a la seva línia de temps de Facebook
• WhatsApp — envia un missatge amb l'enllaç de la insígnia
• Telegram — envia un missatge amb l'enllaç de la insígnia
• Send Email — obre un modal a la mateixa pàgina que envia un correu electrònic amb estil a un o diversos destinataris (vegeu Compartició per correu electrònic a continuació)
• Copy Link — copia l'URL de verificació al porta-retalls
• Embed snippets — copia HTML <img> i <iframe> llestos per enganxar i col·locar la insígnia en un lloc web, intranet o signatura de correu electrònic

Verificació amb QR

Una pàgina de verificació dedicada renderitza un codi QR escanejable que apunta a la seva pròpia URL — perfecte per a certificats impresos, banners d'esdeveniments o captures de pantalla per a LinkedIn.

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

Qualsevol persona que escanegi el QR amb la càmera del telèfon arriba a la pàgina de verificació en directe, on pot confirmar que la insígnia està allotjada a badges.ninja, segueix l'especificació Open Badge v2.0 i (al pla Pro) està ancorada on-chain mitjançant Matchain. La identitat del destinatari es mostra com un hash SHA-256, així els correus electrònics mai no s'exposen públicament.

Certificat PDF

Cada premi té un botó Download Certificate a la pàgina pública de verificació. En clicar-lo, es genera al moment un PDF A4 llest per imprimir que inclou la imatge de la insígnia, el nom del destinatari, l'emissor, els criteris, la data d'emissió, una caducitat opcional i un codi QR que enllaça de tornada a l'URL de verificació en directe.

Previsualitzacions a xarxes socials

Quan un enllaç d'insígnia es comparteix a LinkedIn, X, Slack, Facebook, WhatsApp o per correu electrònic, la plataforma obté el share endpoint i renderitza una targeta enriquida a partir de les metadades Open Graph que badges.ninja emet:

• La imatge de la insígnia com a imatge de previsualització
• El nom de la insígnia com a títol
• El nom de l'emissor i el nom del destinatari a la descripció

Això assegura que les insígnies es vegin professionals on sigui que es comparteixin — els destinataris no han d'adjuntar la seva pròpia imatge ni escriure cap text. La previsualització es genera al servidor a /certify-badge/award/{guid}/share-html i s'emmagatzema a la memòria cau de l'edge del CDN, de manera que les previsualitzacions apareixen instantàniament fins i tot a la primera compartició.

Compartició per correu electrònic

Pots enviar premis d'insígnia per correu electrònic de dues maneres:

Des de la pàgina pública per compartir

Els destinataris poden compartir la seva insígnia amb amics, mentors o possibles ocupadors fent clic a Send Email a la pàgina per compartir. S'obre un modal on introdueixen una o diverses adreces de correu electrònic, un assumpte opcional i un missatge personal:

Cada destinatari rep un correu electrònic HTML amb estil amb el missatge personal del destinatari i un botó d'un sol clic per veure la pàgina pública del premi:

Des del tauler

Els emissors poden enviar qualsevol premi per correu electrònic des de la pàgina Awards al tauler:

1. Localitza el premi a la pàgina Awards.
2. Fes clic al botó Send de la fila, o obre el modal de detalls i fes clic a Resend email.
3. Introdueix el correu electrònic del destinatari i envia.

S'utilitza la mateixa plantilla de correu electrònic per a ambdós fluxos.

Punts de connexió JSON d'Open Badge v2.0

Per a la interoperabilitat amb altres plataformes d'insígnies, badges.ninja proporciona JSON estàndard Open Badge v2.0 en aquests endpoints públics:

Endpoint	Descripció
/certify-badge/issuer/{guid}	JSON del perfil de l'emissor
/certify-badge/badge/{guid}	JSON de BadgeClass
/certify-badge/award/{guid}	JSON d'Assertion (el premi)

Aquests endpoints retornen JSON-LD compatible amb l'especificació Open Badge v2.0. Altres plataformes d'insígnies i verificadors poden consumir aquestes dades per validar credencials.

Exemple — verifica un premi:

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 d'imatges IPFS

Les imatges de les insígnies estan fixades a IPFS (the InterPlanetary File System) a través del nostre propi gateway, ipfs.ninja. Això vol dir:

• Les imatges són permanents i adreçades per contingut — no es poden manipular ni substituir silenciosament
• Les URL d'imatge al JSON d'Open Badge es veuen així: https://ipfs.ninja/ipfs/{cid}
• El mateix content-ID es resol a través de qualsevol gateway IPFS públic (cloudflare-ipfs.com, ipfs.io, etc.) — les teves insígnies no estan lligades a un sol proveïdor

Com que la imatge forma part de l'assertion d'Open Badge, substituir el disseny de la insígnia més tard no trenca els premis emesos prèviament: el CID antic d'IPFS continua sent resoluble per sempre, així que els premis històrics conserven la imatge original encara que redissenyis la insígnia per a noves emissions.