Compartir y verificar

Cada concesión en badges.ninja tiene una página pública de verificación a la que cualquiera puede acceder sin iniciar sesión. Los destinatarios pueden compartir sus insignias en redes sociales, por correo electrónico o copiando un enlace directo.

Los destinatarios también disponen de su propio portal

Si has obtenido una insignia a través de badges.ninja, puedes iniciar sesión (sin contraseña) en badges.ninja/me para ver todas tus insignias en un mismo sitio y mantener un perfil público en badges.ninja/u/<tu-handle>. Consulta el Portal del destinatario.

Página pública de la concesión

Cada concesión tiene una URL pública:

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

Esta página muestra la imagen de la insignia (cargada desde IPFS), el nombre y la descripción de la insignia, el nombre del destinatario, el nombre y el logotipo del emisor, la fecha de emisión y cualquier fecha de caducidad, así como los criterios que ha cumplido el destinatario para obtener la insignia. Cualquier persona con el enlace puede abrir la página para confirmar que la credencial es auténtica.

Si el emisor ha establecido un ID de organización de LinkedIn, aparece el botón Add to LinkedIn profile para que el destinatario pueda guardar la credencial directamente en sus Licencias y Certificaciones de LinkedIn. El botón Download Badge sirve la imagen original de la insignia (directamente desde IPFS) y Download PDF genera al instante un certificado A4 listo para imprimir.

Página pública para compartir

La página para compartir ofrece opciones de difusión social:

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

Desde esta página, los destinatarios pueden compartir su insignia en:

• LinkedIn — publica en su feed de LinkedIn o añade la credencial directamente a su perfil mediante el botón Add to LinkedIn Profile (cuando el emisor ha establecido un ID de organización de LinkedIn)
• Twitter / X — publica un tuit con el enlace de la insignia y un texto personalizado
• Facebook — comparte en su biografía de Facebook
• WhatsApp — envía un mensaje con el enlace de la insignia
• Telegram — envía un mensaje con el enlace de la insignia
• Send Email — abre una ventana modal en la propia página que entrega un correo electrónico estilizado a uno o varios destinatarios (consulta Envío por correo electrónico más abajo)
• Copy Link — copia la URL de verificación al portapapeles
• Embed snippets — copia HTML <img> y <iframe> listo para pegar y así incrustar la insignia en un sitio web, una intranet o una firma de correo

Verificación con QR

Una página de verificación específica muestra un código QR escaneable que apunta a su propia URL — perfecta para certificados impresos, banners de eventos o capturas de pantalla en LinkedIn.

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

Cualquiera que escanee el QR con la cámara del móvil llega a la página de verificación en vivo, donde puede confirmar que la insignia está alojada en badges.ninja, sigue la especificación Open Badge v2.0 y (en el plan Pro) está anclada on-chain a través de Matchain. La identidad del destinatario se muestra como un hash SHA-256, de modo que los correos electrónicos nunca quedan expuestos públicamente.

Certificado en PDF

Cada concesión cuenta con un botón Download Certificate en la página pública de verificación. Al pulsarlo, se genera al instante un PDF A4 listo para imprimir que incluye la imagen de la insignia, el nombre del destinatario, el emisor, los criterios, la fecha de emisión, una caducidad opcional y un código QR que enlaza con la URL de verificación en vivo.

Vistas previas en redes sociales

Cuando se comparte un enlace de insignia en LinkedIn, X, Slack, Facebook, WhatsApp o por correo, la plataforma consulta el endpoint para compartir y muestra una tarjeta enriquecida a partir de los metadatos Open Graph que emite badges.ninja:

• Imagen de la insignia como imagen de vista previa
• Nombre de la insignia como título
• Nombre del emisor y nombre del destinatario en la descripción

Esto garantiza que las insignias luzcan profesionales en cualquier sitio donde se compartan — los destinatarios no tienen que adjuntar su propia imagen ni redactar el texto. La vista previa se genera en el servidor en /certify-badge/award/{guid}/share-html y se almacena en caché en el edge del CDN, por lo que las vistas previas aparecen al instante incluso la primera vez que se comparte.

Envío por correo electrónico

Puedes enviar concesiones de insignias por correo electrónico de dos formas:

Desde la página pública para compartir

Los destinatarios pueden compartir su insignia con amigos, mentores o posibles empleadores haciendo clic en Send Email en la página para compartir. Se abre una ventana modal donde introducen una o varias direcciones de correo, un asunto opcional y un mensaje personal:

Cada destinatario recibe un correo HTML estilizado con el mensaje personal del remitente y un botón de un solo clic para ver la página pública de la concesión:

Desde el panel

Los emisores pueden enviar cualquier concesión por correo electrónico desde la página Awards del panel:

1. Localiza la concesión en la página Awards.
2. Haz clic en el botón Send de la fila o abre la ventana modal de detalle y haz clic en Resend email.
3. Introduce el correo del destinatario y envíalo.

Se utiliza la misma plantilla de correo en ambos flujos.

Endpoints JSON de Open Badge v2.0

Para la interoperabilidad con otras plataformas de insignias, badges.ninja proporciona JSON estándar de Open Badge v2.0 en estos endpoints públicos:

Endpoint	Descripción
/certify-badge/issuer/{guid}	JSON del perfil del emisor
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (la concesión)

Estos endpoints devuelven JSON-LD conforme con la especificación Open Badge v2.0. Otras plataformas de insignias y verificadores pueden consumir estos datos para validar las credenciales.

Ejemplo — verifica una concesión:

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"
  }
}

URLs de imágenes en IPFS

Las imágenes de las insignias se fijan en IPFS (el InterPlanetary File System) a través de nuestra propia pasarela, ipfs.ninja. Esto significa:

• Las imágenes son permanentes y se direccionan por contenido — no pueden manipularse ni sustituirse de manera silenciosa
• Las URLs de las imágenes en el JSON de Open Badge tienen este aspecto: https://ipfs.ninja/ipfs/{cid}
• El mismo content-ID se resuelve a través de cualquier pasarela pública de IPFS (cloudflare-ipfs.com, ipfs.io, etc.) — tus insignias no quedan atadas a un único proveedor

Como la imagen forma parte del assertion de Open Badge, sustituir el diseño de la insignia más adelante no rompe las concesiones emitidas previamente: el antiguo CID de IPFS sigue siendo resoluble para siempre, de modo que las concesiones históricas conservan su imagen original aunque rediseñes la insignia para nuevas emisiones.