Deljenje in preverjanje

Vsaka podelitev na badges.ninja ima javno stran za preverjanje, do katere lahko vsakdo dostopa brez prijave. Prejemniki lahko svoje značke delijo prek družbenih omrežij, e-pošte ali tako, da kopirajo neposredno povezavo.

Prejemniki imajo svoj portal

Če ste prek badges.ninja prejeli značko, se lahko prijavite (geslo ni potrebno) na badges.ninja/me, da na enem mestu vidite vse svoje značke in si uredite javni profil na badges.ninja/u/<vaš-vzdevek>. Glejte Portal za prejemnike.

Javna stran podelitve

Vsaka podelitev ima javni URL:

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

Ta stran prikazuje sliko značke (naloženo z IPFS), ime in opis značke, ime prejemnika, ime in logotip izdajatelja, datum izdaje in morebitni datum poteka ter merila, ki jih je prejemnik izpolnil za pridobitev značke. Vsakdo s povezavo lahko odpre stran in potrdi, da je poverilnica pristna.

Če je izdajatelj nastavil ID organizacije na LinkedIn, se prikaže gumb Dodaj v profil LinkedIn, tako da lahko prejemnik poverilnico shrani neposredno v svoje licence in certifikate na LinkedIn. Gumb Prenesi značko vam ponudi izvirno sliko značke (neposredno z IPFS), gumb Prenesi PDF pa sproti ustvari natisljivo potrdilo formata A4.

Javna stran za deljenje

Stran za deljenje ponuja možnosti za deljenje na družbenih omrežjih:

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

Na tej strani lahko prejemniki delijo svojo značko prek:

• LinkedIn — objavi v njihovem viru LinkedIn ali z gumbom Dodaj v profil LinkedIn poverilnico doda neposredno v njihov profil (ko je izdajatelj nastavil ID organizacije na LinkedIn)
• Twitter / X — objavi tvit s povezavo do značke in prilagojenim besedilom za deljenje
• Facebook — deli na njihovi časovnici Facebook
• WhatsApp — pošlje sporočilo s povezavo do značke
• Telegram — pošlje sporočilo s povezavo do značke
• Send Email — odpre modalno okno na strani, ki dostavi oblikovano e-pošto enemu ali več prejemnikom (glejte Deljenje po e-pošti spodaj)
• Copy Link — kopira URL za preverjanje v odložišče
• Embed snippets — kopira pripravljene HTML odrezke <img> in <iframe> za vdelavo značke v spletno stran, intranet ali podpis e-pošte

Preverjanje s QR kodo

Posebna stran za preverjanje izriše skenirano QR kodo, ki kaže na svoj URL — odlično za natisnjena potrdila, plakate dogodkov ali posnetke zaslona za LinkedIn.

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

Vsakdo, ki QR kodo skenira s kamero telefona, pristane na živi strani za preverjanje, kjer lahko potrdi, da je značka gostovana na badges.ninja, da sledi specifikaciji Open Badge v2.0 in (na paketu Pro) da je sidrana na verigi blokov prek Matchain. Identiteta prejemnika je prikazana kot razpršilna vrednost SHA-256, tako da e-poštni naslovi nikoli niso javno izpostavljeni.

Potrdilo PDF

Vsaka podelitev ima na javni strani za preverjanje gumb Prenesi potrdilo. S klikom nanj se sproti ustvari PDF formata A4, pripravljen za tisk, ki vključuje sliko značke, ime prejemnika, izdajatelja, merila, datum izdaje, neobvezni datum poteka in QR kodo, ki vodi nazaj na živi URL za preverjanje.

Predogledi za družbena omrežja

Ko se povezava do značke deli na LinkedIn, X, Slack, Facebook, WhatsApp ali po e-pošti, platforma pridobi končno točko za deljenje in izriše bogato kartico iz metapodatkov Open Graph, ki jih badges.ninja oddaja:

• Slika značke kot slika predogleda
• Ime značke kot naslov
• Ime izdajatelja in ime prejemnika v opisu

Tako značke izgledajo profesionalno, kjerkoli so deljene — prejemnikom ni treba prilagati lastne slike ali pisati besedila. Predogled se ustvari na strani strežnika na /certify-badge/award/{guid}/share-html in je predpomnjen na robu CDN, tako da se predogledi prikažejo v trenutku že ob prvem deljenju.

Deljenje po e-pošti

Podelitve značk lahko po e-pošti pošljete na dva načina:

Z javne strani za deljenje

Prejemniki lahko svojo značko delijo s prijatelji, mentorji ali potencialnimi delodajalci s klikom na Send Email na strani za deljenje. Odpre se modalno okno, kjer vnesejo enega ali več e-poštnih naslovov, neobvezno zadevo in osebno sporočilo:

Vsak naslovnik prejme oblikovano e-pošto HTML z osebnim sporočilom prejemnika in gumbom za en klik, s katerim si ogleda javno stran podelitve:

Z nadzorne plošče

Izdajatelji lahko vsako podelitev pošljejo po e-pošti s strani Awards na nadzorni plošči:

1. Poiščite podelitev na strani Awards.
2. Kliknite gumb Send v vrstici ali odprite modalno okno s podrobnostmi in kliknite Resend email.
3. Vnesite e-poštni naslov prejemnika in pošljite.

Za oba poteka se uporablja ista e-poštna predloga.

Končne točke JSON Open Badge v2.0

Za interoperabilnost z drugimi platformami za značke badges.ninja na teh javnih končnih točkah ponuja standardni JSON Open Badge v2.0:

Končna točka	Opis
/certify-badge/issuer/{guid}	JSON profila izdajatelja
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (podelitev)

Te končne točke vračajo JSON-LD, skladen s specifikacijo Open Badge v2.0. Druge platforme za značke in preverjevalniki lahko te podatke uporabijo za potrjevanje poverilnic.

Primer — preverite podelitev:

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

Naslovi URL slik na IPFS

Slike značk so pripete na IPFS (InterPlanetary File System) prek našega lastnega prehoda ipfs.ninja. To pomeni:

• Slike so trajne in naslovljene po vsebini — ni jih mogoče spreminjati ali tiho zamenjati
• URL-ji slik v JSON Open Badge izgledajo kot https://ipfs.ninja/ipfs/{cid}
• Isti vsebinski ID se razreši prek katerega koli javnega prehoda IPFS (cloudflare-ipfs.com, ipfs.io itd.) — vaše značke niso vezane na enega samega ponudnika

Ker je slika del trditve Open Badge, kasnejša zamenjava grafike značke ne pokvari predhodno izdanih podelitev: stari CID na IPFS ostane razreljiv za vedno, tako da pretekle podelitve ohranijo svojo izvirno sliko, tudi če značko za nove izdaje preoblikujete.