Skip to content

Deling og verifisering

Hver utmerkelse på badges.ninja har en offentlig verifiseringsside som hvem som helst kan åpne uten å logge inn. Mottakere kan dele merkene sine i sosiale medier, via e-post eller ved å kopiere en direktelenke.

Mottakere har sin egen portal også

Hvis du har opptjent et merke gjennom badges.ninja, kan du logge inn (uten passord) på badges.ninja/me for å se alle merkene dine på ett sted og kuratere en offentlig profil på badges.ninja/u/<ditt-brukernavn>. Se Mottakerportal.

Offentlig utmerkelsesside

Hver utmerkelse har en offentlig URL:

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

Denne siden viser merkebildet (lastet inn fra IPFS), merkets navn og beskrivelse, mottakerens navn, utstederens navn og logo, utstedelsesdato og en eventuell utløpsdato, samt kriteriene mottakeren oppfylte for å oppnå merket. Alle med lenken kan åpne siden for å bekrefte at legitimasjonen er ekte.

Offentlig utmerkelsesside

Hvis utstederen har angitt en LinkedIn-organisasjons-ID, vises knappen Add to LinkedIn profile slik at mottakeren kan lagre legitimasjonen direkte i sin LinkedIn-seksjon for Lisenser og sertifiseringer. Knappen Download Badge leverer det originale merkebildet (rett fra IPFS), og Download PDF genererer et utskriftsklart A4-sertifikat på sparket.

Offentlig delingsside

Delingssiden gir alternativer for sosial deling:

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

Offentlig delingsside med sosiale knapper og innebyggingskodebiter

Fra denne siden kan mottakere dele merket sitt på:

  • LinkedIn — publiserer i LinkedIn-feeden deres, eller legger legitimasjonen direkte til profilen via knappen Add to LinkedIn Profile (når utstederen har satt en LinkedIn-organisasjons-ID)
  • Twitter / X — publiserer en tweet med merkelenken og tilpasset delingstekst
  • Facebook — deler på Facebook-tidslinjen deres
  • WhatsApp — sender en melding med merkelenken
  • Telegram — sender en melding med merkelenken
  • Send Email — åpner et modalvindu på siden som leverer en stilisert e-post til én eller flere mottakere (se E-postdeling nedenfor)
  • Copy Link — kopierer verifiserings-URL-en til utklippstavlen
  • Embed snippets — kopierer ferdig-til-å-lime-inn HTML for <img> og <iframe> for å plassere merket på en nettside, intranett eller e-postsignatur

QR-verifisering

En dedikert verifiseringsside genererer en skannbar QR-kode som peker til sin egen URL — perfekt for trykte sertifikater, arrangementsbannere eller LinkedIn-skjermbilder.

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

QR-verifiseringsside med merkets identitet, blokkjedebevis og skannbar QR-kode

Alle som skanner QR-koden med et telefonkamera, lander på den live verifiseringssiden, der de kan bekrefte at merket er driftet på badges.ninja, følger Open Badge v2.0-spesifikasjonen og (på Pro-planen) er forankret on-chain via Matchain. Mottakerens identitet vises som en SHA-256-hash, slik at e-poster aldri eksponeres offentlig.

PDF-sertifikat

Hver utmerkelse har en knapp Download Certificate på den offentlige verifiseringssiden. Når du klikker på den, genereres en utskriftsklar A4-PDF på sparket som inkluderer merkebildet, mottakerens navn, utsteder, kriterier, utstedelsesdato, valgfri utløpsdato og en QR-kode som lenker tilbake til den live verifiserings-URL-en.

Forhåndsvisninger i sosiale medier

Når en merkelenke deles på LinkedIn, X, Slack, Facebook, WhatsApp eller e-post, henter plattformen delings-endepunktet og viser et rikt kort fra Open Graph-metadataene som badges.ninja sender ut:

  • Merkebildet som forhåndsvisningsbilde
  • Merkets navn som tittel
  • Utsteders navn og mottakers navn i beskrivelsen

Hvordan en delt merkelenke vises som et forhåndsvisningskort i sosiale medier

Dette sikrer at merker ser profesjonelle ut når de deles hvor som helst — mottakere trenger ikke å legge ved sitt eget bilde eller skrive tekst. Forhåndsvisningen genereres på serversiden på /certify-badge/award/{guid}/share-html og caches på CDN-kanten, slik at forhåndsvisninger vises umiddelbart selv ved første deling.

E-postdeling

Du kan sende merkeutmerkelser via e-post på to måter:

Fra den offentlige delingssiden

Mottakere kan dele merket sitt med venner, mentorer eller potensielle arbeidsgivere ved å klikke på Send Email på delingssiden. Et modalvindu åpnes der de skriver inn én eller flere e-postadresser, et valgfritt emne og en personlig melding:

Modalvindu for e-postsending på siden — mottakere skriver inn adresser, emne og en personlig notis

Hver mottaker får en stilisert HTML-e-post med mottakerens personlige melding og en ettklikks-knapp for å se den offentlige utmerkelsessiden:

Den faktiske e-posten hver mottaker får

Fra dashbordet

Utstedere kan sende enhver utmerkelse via e-post fra Awards-siden i dashbordet:

  1. Finn utmerkelsen på Awards-siden.
  2. Klikk på knappen Send på raden, eller åpne detaljmodalen og klikk på Resend email.
  3. Skriv inn mottakerens e-post og send.

Den samme e-postmalen brukes for begge arbeidsflytene.

Open Badge v2.0 JSON-endepunkter

For interoperabilitet med andre merkeplattformer leverer badges.ninja standard Open Badge v2.0 JSON på disse offentlige endepunktene:

EndepunktBeskrivelse
/certify-badge/issuer/{guid}JSON for utstederprofil
/certify-badge/badge/{guid}BadgeClass JSON
/certify-badge/award/{guid}Assertion JSON (utmerkelsen)

Disse endepunktene returnerer JSON-LD i samsvar med Open Badge v2.0-spesifikasjonen. Andre merkeplattformer og verifikatorer kan konsumere disse dataene for å validere legitimasjon.

Eksempel — verifiser en utmerkelse:

bash
curl https://api.badges.ninja/certify-badge/award/abc123-def456
json
{
  "@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-bilde-URL-er

Merkebilder festes til IPFS (InterPlanetary File System) gjennom vår egen gateway, ipfs.ninja. Dette betyr:

  • Bildene er permanente og innholdsadresserte — de kan ikke manipuleres eller stille erstattes
  • Bilde-URL-er i Open Badge JSON ser ut som https://ipfs.ninja/ipfs/{cid}
  • Den samme innholds-ID-en kan løses gjennom enhver offentlig IPFS-gateway (cloudflare-ipfs.com, ipfs.io osv.) — merkene dine er ikke låst til én leverandør

Siden bildet er en del av Open Badge-assertion, vil ikke senere utskifting av merkets grafikk ødelegge tidligere utstedte utmerkelser: den gamle IPFS CID-en forblir oppløsbar for alltid, slik at historiske utmerkelser beholder sitt opprinnelige bilde selv om du redesigner merket for nye utstedelser.

badges.ninja Documentation