Compartir y verificar

Cada otorgamiento en badges.ninja cuenta con 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 tienen su propio portal

Si ganaste una insignia a través de badges.ninja, podés iniciar sesión (sin contraseña) en badges.ninja/me para ver todas tus insignias en un solo lugar y armar un perfil público en badges.ninja/u/<tu-handle>. Mirá el Portal del destinatario.

Página pública del otorgamiento

Cada otorgamiento 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 logo del emisor, la fecha de emisión y cualquier fecha de vencimiento, y los criterios que cumplió el destinatario para ganar la insignia. Cualquiera con el enlace puede abrir la página para confirmar que la credencial es auténtica.

Si el emisor configuró 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 entrega 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 agrega la credencial directamente a su perfil mediante el botón Add to LinkedIn Profile (cuando el emisor configuró 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 página que envía un correo electrónico estilizado a uno o varios destinatarios (mirá Compartir 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í colocar la insignia en un sitio web, una intranet o una firma de correo

Verificación con QR

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

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

Quien escanee el QR con la cámara del teléfono 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 mediante Matchain. La identidad del destinatario se muestra como un hash SHA-256, así los correos electrónicos nunca se exponen públicamente.

Certificado en PDF

Cada otorgamiento tiene un botón Download Certificate en la página pública de verificación. Al hacer clic, 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, el vencimiento opcional y un código QR que enlaza de vuelta a 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 se vean profesionales en cualquier lugar donde se compartan — los destinatarios no tienen que adjuntar su propia imagen ni redactar copys. La vista previa se genera del lado del servidor en /certify-badge/award/{guid}/share-html y se cachea en el edge del CDN, por lo que las vistas previas aparecen al instante incluso en la primera vez que se comparte.

Compartir por correo electrónico

Podés enviar otorgamientos de insignias por correo electrónico de dos maneras:

Desde la página pública para compartir

Los destinatarios pueden compartir su insignia con amigos, mentores o potenciales empleadores haciendo clic en Send Email en la página para compartir. Se abre una ventana modal donde ingresan una o más 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 del otorgamiento:

Desde el panel

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

1. Encontrá el otorgamiento en la página Awards.
2. Hacé clic en el botón Send en la fila, o abrí el modal de detalle y hacé clic en Resend email.
3. Ingresá el correo del destinatario y enviá.

Se usa 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 (el otorgamiento)

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

Ejemplo — verificá un otorgamiento:

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 nuestro propio gateway, ipfs.ninja. Esto significa:

• Las imágenes son permanentes y direccionadas por contenido — no pueden ser manipuladas ni reemplazadas en silencio
• Las URLs de las imágenes en el JSON de Open Badge se ven así: https://ipfs.ninja/ipfs/{cid}
• El mismo content-ID se resuelve a través de cualquier gateway público 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, reemplazar el arte de la insignia más adelante no rompe los otorgamientos previamente emitidos: el viejo CID de IPFS sigue siendo resoluble para siempre, así que los otorgamientos históricos conservan su imagen original aunque rediseñes la insignia para emisiones nuevas.