Deling og verifikation

Hver tildeling på badges.ninja har en offentlig verifikationsside, som alle kan tilgå uden at logge ind. Modtagere kan dele deres badges på sociale medier, via e-mail eller ved at kopiere et direkte link.

Modtagere har også deres egen portal

Hvis du har optjent et badge gennem badges.ninja, kan du logge ind (uden adgangskode) på badges.ninja/me for at se alle dine badges samlet ét sted og kuratere en offentlig profil på badges.ninja/u/<dit-handle>. Se Modtagerportalen.

Offentlig tildelingsside

Hver tildeling har en offentlig URL:

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

Denne side viser badge-billedet (indlæst fra IPFS), badgets navn og beskrivelse, modtagerens navn, udstederens navn og logo, udstedelsesdatoen og en eventuel udløbsdato samt de kriterier, modtageren har opfyldt for at optjene badget. Alle med linket kan åbne siden for at bekræfte, at akkreditiven er ægte.

Hvis udstederen har angivet et LinkedIn organization ID, vises knappen Add to LinkedIn profile, så modtageren kan gemme akkreditiven direkte i sin LinkedIn Licenses & Certifications. Knappen Download Badge leverer det originale badge-billede (direkte fra IPFS), og Download PDF genererer et printklart A4-certifikat med det samme.

Offentlig delingsside

Delingssiden tilbyder muligheder for social deling:

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

Fra denne side kan modtagere dele deres badge på:

• LinkedIn — slår op på deres LinkedIn-feed eller tilføjer akkreditiven direkte til deres profil via knappen Add to LinkedIn Profile (når udstederen har angivet et LinkedIn organization ID)
• Twitter / X — slår et tweet op med badge-linket og brugerdefineret delingstekst
• Facebook — deler på deres Facebook-tidslinje
• WhatsApp — sender en besked med badge-linket
• Telegram — sender en besked med badge-linket
• Send Email — åbner en modal på siden, der leverer en stiliseret e-mail til en eller flere modtagere (se E-mail-deling nedenfor)
• Copy Link — kopierer verifikations-URL'en til udklipsholderen
• Embed snippets — kopierer klar-til-indsæt <img>- og <iframe>-HTML for at indsætte badget på et website, intranet eller i en e-mail-signatur

QR-verifikation

En dedikeret verifikationsside gengiver en scanbar QR-kode, der peger på sin egen URL — perfekt til trykte certifikater, eventbannere eller LinkedIn-screenshots.

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

Alle, der scanner QR-koden med et telefonkamera, lander på den live verifikationsside, hvor de kan bekræfte, at badget er hostet på badges.ninja, følger Open Badge v2.0-specifikationen og (på Pro-planen) er forankret on-chain via Matchain. Modtageridentiteten vises som et SHA-256-hash, så e-mails aldrig eksponeres offentligt.

PDF-certifikat

Hver tildeling har en Download Certificate-knap på den offentlige verifikationsside. Når der klikkes på den, genereres en printklar A4-PDF med det samme, som inkluderer badge-billedet, modtagerens navn, udstederen, kriterierne, udstedelsesdatoen, en valgfri udløbsdato og en QR-kode, der linker tilbage til den live verifikations-URL.

Forhåndsvisninger på sociale medier

Når et badge-link deles på LinkedIn, X, Slack, Facebook, WhatsApp eller i en e-mail, henter platformen share-endpoint'et og gengiver et rigt kort baseret på de Open Graph-metadata, som badges.ninja udsender:

• Badge-billede som forhåndsvisningsbillede
• Badge-navn som titel
• Udstederens navn og modtagerens navn i beskrivelsen

Dette sikrer, at badges ser professionelle ud, uanset hvor de deles — modtagere behøver ikke at vedhæfte deres eget billede eller skrive tekst. Forhåndsvisningen genereres på serversiden på /certify-badge/award/{guid}/share-html og caches på CDN-edgen, så forhåndsvisninger vises øjeblikkeligt selv ved første deling.

E-mail-deling

Du kan sende badge-tildelinger via e-mail på to måder:

Fra den offentlige delingsside

Modtagere kan dele deres badge med venner, mentorer eller potentielle arbejdsgivere ved at klikke på Send Email på delingssiden. En modal åbnes, hvor de indtaster en eller flere e-mail-adresser, et valgfrit emne og en personlig besked:

Hver adressat modtager en stiliseret HTML-e-mail med modtagerens personlige besked og en ét-kliks-knap til at se den offentlige tildelingsside:

Fra dashboardet

Udstedere kan sende enhver tildeling via e-mail fra Awards-siden i dashboardet:

1. Find tildelingen på Awards-siden.
2. Klik på Send-knappen på rækken, eller åbn detaljemodalen og klik på Resend email.
3. Indtast modtagerens e-mail og send.

Den samme e-mail-skabelon bruges til begge flows.

Open Badge v2.0 JSON-endpoints

For interoperabilitet med andre badge-platforme leverer badges.ninja standard Open Badge v2.0 JSON på disse offentlige endpoints:

Endpoint	Beskrivelse
/certify-badge/issuer/{guid}	JSON for udstederprofil
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (tildelingen)

Disse endpoints returnerer JSON-LD i overensstemmelse med Open Badge v2.0-specifikationen. Andre badge-platforme og verifikatorer kan forbruge disse data for at validere akkreditiver.

Eksempel — verificer en tildeling:

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-billed-URL'er

Badge-billeder er pinnet til IPFS (the InterPlanetary File System) gennem vores egen gateway, ipfs.ninja. Det betyder:

• Billeder er permanente og indholdsadresserede — de kan ikke manipuleres eller stille udskiftes
• Billed-URL'er i Open Badge JSON ser sådan ud: https://ipfs.ninja/ipfs/{cid}
• Det samme content-ID resolveres gennem enhver offentlig IPFS-gateway (cloudflare-ipfs.com, ipfs.io, osv.) — dine badges er ikke låst til en enkelt udbyder

Fordi billedet er en del af Open Badge-assertionen, bryder en senere udskiftning af badge-grafikken ikke tidligere udstedte tildelinger: det gamle IPFS CID forbliver resolverbart for evigt, så historiske tildelinger beholder deres originale billede, selv hvis du redesigner badget til nye udstedelser.