Delen & verificatie

Elke referentie op badges.ninja heeft een publieke verificatiepagina die iedereen kan openen zonder in te loggen. Ontvangers kunnen hun badges delen op sociale media, per e-mail of door een directe link te kopiëren.

Ontvangers hebben ook een eigen portaal

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

Publieke referentiepagina

Elke referentie heeft een publieke URL:

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

Deze pagina toont de badge-afbeelding, 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. Iedereen met de link kan de pagina openen om te bevestigen dat de referentie authentiek is.

De referentiepagina toont altijd een knop Toevoegen aan LinkedIn-profiel, zodat de ontvanger de referentie direct kan opslaan bij Licenties en certificeringen op LinkedIn. (Als de uitgever een LinkedIn-organisatie-ID heeft ingesteld, vult LinkedIn de geverifieerde bedrijfspagina vooraf in; anders wordt de naam van de uitgever gebruikt.) Een enkel uitklapmenu Downloaden biedt twee opties: Badge-afbeelding (de originele PNG) en Certificaat (een afdrukbare A4-PDF die direct wordt gegenereerd op /certify-badge/award/{guid}/pdf).

Publieke deelpagina

De deelpagina biedt opties om te delen op sociale media:

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

Vanaf deze pagina kunnen ontvangers hun badge delen op:

• LinkedIn — plaatst de badge in hun LinkedIn-feed (om de referentie rechtstreeks aan hun profiel toe te voegen, gebruik je in plaats daarvan de knop Toevoegen aan LinkedIn-profiel op de referentiepagina)
• Twitter / X — plaatst een tweet met de badge-link en een eigen deeltekst
• Facebook — deelt op hun Facebook-tijdlijn
• WhatsApp — verstuurt een bericht met de badge-link
• Telegram — verstuurt een bericht met de badge-link
• E-mail versturen — opent een modaal venster op de pagina dat een vormgegeven e-mail naar één of meerdere ontvangers verstuurt (zie Delen per e-mail hieronder)
• Link kopiëren — kopieert de verificatie-URL naar het klembord
• Insluitcodes — kopieer kant-en-klare <img>- en <iframe>-HTML om de badge op te nemen in een website, intranet of e-mailhandtekening

QR-verificatie

Een speciale verificatiepagina toont een scanbare QR-code die naar de eigen URL verwijst — perfect voor afgedrukte certificaten, evenementbanners of LinkedIn-screenshots.

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

Iedereen die de QR-code met een telefooncamera scant, komt op de live verificatiepagina, waar ze kunnen bevestigen dat de badge wordt gehost op badges.ninja en voldoet aan de Open Badge v2.0-specificatie. De identiteit van de ontvanger wordt getoond als SHA-256-hash, zodat e-mailadressen nooit publiek zichtbaar zijn.

PDF-certificaat

Elke referentie kan worden gedownload als afdrukklaar A4-PDF-certificaat. De optie Certificaat staat in het uitklapmenu Downloaden op de publieke referentiepagina (/awards/{guid}) — niet op de verificatiepagina, die alleen de scanbare QR-code en de ruwe Open Badge-JSON bevat. Als je die kiest, wordt de PDF direct gegenereerd (op /certify-badge/award/{guid}/pdf) met de badge-afbeelding, naam van de ontvanger, uitgever, criteria, uitgiftedatum, optionele vervaldatum en een QR-code die terugverwijst naar de live verificatie-URL.

Voorvertoningen op sociale media

Wanneer een badge-link wordt gedeeld op LinkedIn, X, Slack, Facebook, WhatsApp of per e-mail, haalt het platform het deel-endpoint op en toont het een rijke kaart op basis van de Open Graph-metadata die badges.ninja meestuurt:

• Badge-afbeelding als voorbeeldafbeelding
• Badge-naam als titel
• Naam van de uitgever en naam van de ontvanger in de beschrijving

Zo zien badges er overal professioneel uit wanneer ze worden gedeeld — ontvangers hoeven geen eigen afbeelding bij te voegen of tekst te schrijven. De voorvertoning wordt server-side gegenereerd op /certify-badge/award/{guid}/share-html en gecachet aan de CDN-edge, zodat voorvertoningen direct verschijnen, zelfs bij de eerste keer delen.

Delen per e-mail

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

Vanaf de publieke deelpagina

Ontvangers kunnen hun badge delen met vrienden, mentoren of mogelijke werkgevers door op de deelpagina op E-mail versturen te klikken. Er opent een modaal venster waarin ze een of meer e-mailadressen, een optioneel onderwerp en een persoonlijk bericht invoeren:

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

Vanuit het dashboard

Uitgevers kunnen elke referentie per e-mail versturen vanaf de pagina Referenties in het dashboard:

1. Zoek de referentie op de pagina Referenties.
2. Klik op de knop Verzenden in de rij, of open het detailvenster en klik op E-mail opnieuw verzenden.
3. Voer het e-mailadres van de ontvanger in en verstuur.

Voor beide manieren wordt dezelfde e-mailsjabloon gebruikt.

Open Badge v2.0 JSON-endpoints

Voor interoperabiliteit met andere badgeplatforms levert badges.ninja standaard Open Badge v2.0-JSON op deze publieke endpoints:

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

Deze endpoints geven JSON-LD terug dat voldoet aan de Open Badge v2.0-specificatie. Andere badgeplatforms en verificateurs kunnen deze gegevens gebruiken om referenties te valideren.

Voorbeeld — een referentie verifiëren:

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's van badge-afbeeldingen

Badge-afbeeldingen worden opgeslagen op Amazon S3 en geserveerd via ons wereldwijde CDN onder een inhoudsgeadresseerde, onveranderlijke URL die is afgeleid van een cryptografische hash (SHA-256) van de bytes van de afbeelding. Dit betekent:

• Afbeeldingen zijn permanent en inhoudsgeadresseerd — de URL is afgeleid van de bytes zelf, dus ze kunnen niet worden gemanipuleerd of ongemerkt worden vervangen
• Afbeeldings-URL's in de Open Badge-JSON zien eruit als https://badges.ninja/images/{sha256}.png
• Afbeeldingen worden geserveerd vanaf de CDN-edge, zodat ze overal ter wereld snel laden en beschikbaar blijven zolang de referentie bestaat

Omdat de afbeelding deel uitmaakt van de Open Badge-assertion, breekt het later vervangen van de badge-afbeelding eerder uitgegeven referenties niet: de originele afbeelding behoudt zijn eigen inhoudsgeadresseerde URL, zodat bestaande referenties hun oorspronkelijke afbeelding houden, ook als je de badge opnieuw ontwerpt voor nieuwe uitgiftes.