Delen & Verificatie

Elke uitreiking op badges.ninja heeft een openbare verificatiepagina die door iedereen zonder inloggen geopend kan worden. Ontvangers kunnen hun badges delen op sociale media, per e-mail of door een directe link te kopiëren.

Ontvangers hebben ook hun eigen portaal

Als je een badge hebt verdiend via badges.ninja, kun je inloggen (zonder wachtwoord) op badges.ninja/me om al je badges op één plek te bekijken en een openbaar profiel samen te stellen op badges.ninja/u/<je-handle>. Zie Ontvangersportaal.

Openbare uitreikingspagina

Elke uitreiking heeft een openbare URL:

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

Op deze pagina worden de badge-afbeelding (geladen vanaf IPFS), de naam en beschrijving van de badge, de naam van de ontvanger, de naam en het logo van de uitgever, de uitgiftedatum en eventuele vervaldatum, en de criteria waaraan de ontvanger heeft voldaan om de badge te verdienen, weergegeven. Iedereen met de link kan de pagina openen om te bevestigen dat het diploma authentiek is.

Als de uitgever een LinkedIn-organisatie-ID heeft ingesteld, verschijnt de knop Add to LinkedIn profile zodat de ontvanger het diploma direct kan opslaan in zijn LinkedIn-sectie Licenties en certificaten. De knop Download Badge levert de originele badge-afbeelding (rechtstreeks vanuit IPFS), en Download PDF genereert direct een afdrukbaar A4-certificaat.

Openbare deelpagina

De deelpagina biedt opties voor sociaal delen:

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

Vanaf deze pagina kunnen ontvangers hun badge delen op:

• LinkedIn — plaatst een bericht in hun LinkedIn-feed, of voegt het diploma direct toe aan hun profiel via de knop Add to LinkedIn Profile (wanneer de uitgever een LinkedIn-organisatie-ID heeft ingesteld)
• Twitter / X — plaatst een tweet met de badge-link en aangepaste deeltekst
• Facebook — deelt op hun Facebook-tijdlijn
• WhatsApp — verzendt een bericht met de badge-link
• Telegram — verzendt een bericht met de badge-link
• Send Email — opent een modaalvenster op de pagina dat een gestylde e-mail levert aan één of meerdere ontvangers (zie E-mail delen hieronder)
• Copy Link — kopieert de verificatie-URL naar het klembord
• Embed snippets — kopieer kant-en-klare HTML voor <img> en <iframe> om de badge in een website, intranet of e-mailhandtekening te plaatsen

QR-verificatie

Een speciale verificatiepagina toont een scanbare QR-code die naar zijn eigen URL verwijst — perfect voor gedrukte certificaten, evenementenbanners of LinkedIn-screenshots.

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

Iedereen die de QR-code met een telefooncamera scant, komt op de live verificatiepagina terecht, waar bevestigd kan worden dat de badge wordt gehost op badges.ninja, voldoet aan de Open Badge v2.0-specificatie en (in het Pro-abonnement) on-chain is verankerd via Matchain. De identiteit van de ontvanger wordt weergegeven als een SHA-256-hash, zodat e-mailadressen nooit openbaar worden onthuld.

PDF-certificaat

Elke uitreiking heeft een knop Download Certificate op de openbare verificatiepagina. Door erop te klikken wordt direct een afdrukklaar A4-PDF gegenereerd dat de badge-afbeelding, de naam van de ontvanger, uitgever, criteria, uitgiftedatum, optionele vervaldatum en een QR-code met een link terug naar de live verificatie-URL bevat.

Voorvertoningen voor sociale media

Wanneer een badge-link wordt gedeeld op LinkedIn, X, Slack, Facebook, WhatsApp of via e-mail, haalt het platform het deelendpoint op en geeft het een rijke kaart weer op basis van de Open Graph-metadata die badges.ninja uitzendt:

• Badge-afbeelding als voorvertoningsafbeelding
• Naam van de badge als titel
• Naam van uitgever en ontvanger in de beschrijving

Dit zorgt ervoor dat badges er overal professioneel uitzien wanneer ze gedeeld worden — ontvangers hoeven geen eigen afbeelding bij te voegen of tekst te schrijven. De voorvertoning wordt aan de serverzijde gegenereerd op /certify-badge/award/{guid}/share-html en gecached aan de rand van het CDN, dus voorvertoningen verschijnen direct, zelfs bij het eerste delen.

E-mail delen

Je kunt uitreikingen op twee manieren per e-mail versturen:

Vanaf de openbare deelpagina

Ontvangers kunnen hun badge delen met vrienden, mentoren of potentiële werkgevers door op Send Email op de deelpagina te klikken. Er opent een modaalvenster waar ze één of meer e-mailadressen, een optioneel onderwerp en een persoonlijk bericht invoeren:

Elke geadresseerde ontvangt een gestylde HTML-e-mail met het persoonlijke bericht van de ontvanger en een knop met één klik om de openbare uitreikingspagina te bekijken:

Vanaf het dashboard

Uitgevers kunnen elke uitreiking per e-mail versturen vanaf de Awards-pagina in het dashboard:

1. Zoek de uitreiking op de Awards-pagina.
2. Klik op de knop Send in de rij, of open het detailmodaal en klik op Resend email.
3. Voer het e-mailadres van de ontvanger in en verstuur.

Voor beide stromen wordt dezelfde e-mailtemplate gebruikt.

Open Badge v2.0 JSON-endpoints

Voor interoperabiliteit met andere badge-platforms biedt badges.ninja standaard Open Badge v2.0 JSON op deze openbare endpoints:

Endpoint	Beschrijving
/certify-badge/issuer/{guid}	JSON van uitgeversprofiel
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (de uitreiking)

Deze endpoints retourneren JSON-LD die voldoet aan de Open Badge v2.0-specificatie. Andere badge-platforms en verificateurs kunnen deze gegevens gebruiken om diploma's te valideren.

Voorbeeld — verifieer een uitreiking:

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

IPFS-afbeeldings-URL's

Badge-afbeeldingen worden gepind op IPFS (het InterPlanetary File System) via onze eigen gateway, ipfs.ninja. Dit betekent:

• Afbeeldingen zijn permanent en inhoud-geadresseerd — ze kunnen niet worden gemanipuleerd of stilletjes vervangen
• Afbeeldings-URL's in de Open Badge JSON zien er uit als https://ipfs.ninja/ipfs/{cid}
• Hetzelfde inhouds-ID is oplosbaar via elke openbare IPFS-gateway (cloudflare-ipfs.com, ipfs.io, enz.) — je badges zijn niet vastgelegd op één enkele provider

Omdat de afbeelding deel uitmaakt van de Open Badge-assertion, breekt het later vervangen van het badge-ontwerp eerder uitgereikte uitreikingen niet: de oude IPFS-CID blijft voor altijd oplosbaar, dus historische uitreikingen behouden hun originele afbeelding zelfs als je de badge opnieuw ontwerpt voor nieuwe uitgiftes.