Deling og verifikation

Hvert bevis på badges.ninja har en offentlig verifikationsside, som alle kan åbne 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 en badge via badges.ninja, kan du logge ind (uden adgangskode) på badges.ninja/me for at se alle dine badges samlet ét sted og opbygge en offentlig profil på badges.ninja/u/<your-handle>. Se Modtagerportal.

Offentlig bevisside

Hvert bevis har en offentlig URL:

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

Siden viser badgens billede, badgens navn og beskrivelse, modtagerens navn, udsteders navn og logo, udstedelsesdatoen og en eventuel udløbsdato samt de kriterier, modtageren opfyldte for at optjene badgen. Alle med linket kan åbne siden og bekræfte, at beviset er ægte.

Bevissiden viser altid en knap Add to LinkedIn profile, så modtageren kan gemme beviset direkte under Licenses & Certifications på LinkedIn. (Hvis udsteder har angivet et LinkedIn organization ID, forudfylder LinkedIn den verificerede virksomhedsside; ellers bruges udsteders navn.) Én enkelt rullemenu, Download, giver to valg: Badge image (den originale PNG) og Certificate (en printvenlig A4-PDF, der genereres løbende på /certify-badge/award/{guid}/pdf).

Offentlig delingsside

Delingssiden giver mulighed for deling på sociale medier:

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

Fra denne side kan modtagere dele deres badge på:

• LinkedIn — opslag med badgen i deres LinkedIn-feed (for at tilføje beviset direkte til profilen skal du i stedet bruge knappen Add to LinkedIn profile på bevissiden)
• Twitter / X — et tweet med badge-linket og en tilpasset 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, som leverer en flot formateret e-mail til én eller flere modtagere (se Deling via e-mail nedenfor)
• Copy Link — kopierer verifikations-URL'en til udklipsholderen
• Indlejringskode — kopiér færdig <img>- og <iframe>-HTML for at sætte badgen ind på et websted, et intranet eller i en e-mailsignatur

QR-verifikation

En dedikeret verifikationsside viser en scanbar QR-kode, der peger på sidens egen URL — perfekt til printede certifikater, eventbannere eller LinkedIn-skærmbilleder.

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

Alle, der scanner QR-koden med telefonens kamera, lander på den levende verifikationsside, hvor de kan bekræfte, at badgen er hostet på badges.ninja og følger Open Badge v2.0-specifikationen. Modtagerens identitet vises som en SHA-256-hash, så e-mailadresser aldrig afsløres offentligt.

PDF-certifikat

Ethvert bevis kan downloades som et printklart A4-PDF-certifikat. Valget Certificate findes i rullemenuen Download på den offentlige bevisside (/awards/{guid}) — ikke på verifikationssiden, som kun har den scanbare QR-kode og den rå Open Badge-JSON. Når du vælger det, genereres PDF'en løbende (på /certify-badge/award/{guid}/pdf) med badgens billede, modtagerens navn, udsteder, kriterier, udstedelsesdato, evt. udløbsdato og en QR-kode, der linker tilbage til den levende verifikations-URL.

Forhåndsvisning på sociale medier

Når et badge-link deles på LinkedIn, X, Slack, Facebook, WhatsApp eller via e-mail, henter platformen delingsendepunktet og viser et rigt kort ud fra de Open Graph-metadata, som badges.ninja udsender:

• Badgens billede som forhåndsvisningsbillede
• Badgens navn som titel
• Udsteders navn og modtagerens navn i beskrivelsen

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

Deling via e-mail

Du kan sende beviser 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 åbner, hvor de indtaster én eller flere e-mailadresser, et valgfrit emne og en personlig besked:

Hver adressat modtager en flot HTML-e-mail med modtagerens personlige besked og en knap, der med ét klik åbner den offentlige bevisside:

Fra dashboardet

Udstedere kan sende ethvert bevis via e-mail fra siden Credentials i dashboardet:

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

Begge fremgangsmåder bruger den samme e-mailskabelon.

JSON-endepunkter til Open Badge v2.0

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

Endepunkt	Beskrivelse
/certify-badge/issuer/{guid}	JSON for udsteders profil
/certify-badge/badge/{guid}	BadgeClass-JSON
/certify-badge/award/{guid}	Assertion-JSON (beviset)

Disse endepunkter returnerer JSON-LD i overensstemmelse med Open Badge v2.0-specifikationen. Andre badge-platforme og verifikatorer kan bruge disse data til at validere beviser.

Eksempel — verificér et bevis:

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

Badge-billed-URL'er

Badge-billeder gemmes på Amazon S3 og leveres via vores globale CDN under en indholdsadresseret, uforanderlig URL, der er udledt af en kryptografisk hash (SHA-256) af billedets bytes. Det betyder:

• Billeder er permanente og indholdsadresserede — URL'en er udledt af selve bytes, så de ikke kan manipuleres eller stiltiende udskiftes
• Billed-URL'er i Open Badge-JSON ser sådan ud: https://badges.ninja/images/{sha256}.png
• Billeder leveres fra CDN-kanten, så de indlæses hurtigt overalt i verden og forbliver tilgængelige, så længe beviset eksisterer

Fordi billedet er en del af Open Badge-assertionen, ødelægger en senere udskiftning af badgens grafik ikke tidligere udstedte beviser: det oprindelige billede beholder sin egen indholdsadresserede URL, så historiske beviser bevarer deres oprindelige billede, selv hvis du redesigner badgen til nye udstedelser.