Deljenje in preverjanje

Vsaka poverilnica na badges.ninja ima javno stran za preverjanje, do katere lahko dostopa kdor koli brez prijave. Prejemniki lahko svoje značke delijo na družbenih omrežjih, po e-pošti ali s kopiranjem neposredne povezave.

Tudi prejemniki imajo svoj portal

Če ste značko pridobili prek badges.ninja, se lahko (brez gesla) prijavite na badges.ninja/me, kjer vidite vse svoje značke na enem mestu in urejate javni profil na badges.ninja/u/<your-handle>. Glejte Portal za prejemnike.

Javna stran poverilnice

Vsaka poverilnica ima javni URL:

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

Ta stran prikazuje sliko značke, 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. Vsak, ki ima povezavo, lahko odpre stran in potrdi pristnost poverilnice.

Stran poverilnice vedno prikazuje gumb Add to LinkedIn profile, da lahko prejemnik poverilnico neposredno shrani med svoje LinkedIn Licenses & Certifications. (Če je izdajatelj nastavil ID organizacije na LinkedInu, LinkedIn vnaprej izpolni preverjeno stran podjetja; sicer uporabi ime izdajatelja.) Enoten spustni meni Download ponuja dve možnosti: Badge image (izvirni PNG) in Certificate (A4 PDF za tisk, ustvarjen sproti na /certify-badge/award/{guid}/pdf).

Javna stran za deljenje

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

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

S te strani lahko prejemniki svojo značko delijo na:

• LinkedIn — objavi značko v njihovem viru na LinkedInu (če želite poverilnico dodati neposredno v profil, namesto tega uporabite gumb Add to LinkedIn profile na strani poverilnice)
• Twitter / X — objavi tvit s povezavo do značke in besedilom za deljenje po meri
• Facebook — deli na njihovi časovnici na Facebooku
• 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
• Odlomki za vdelavo — kopirajte pripravljen HTML <img> in <iframe>, da značko vstavite na spletno mesto, intranet ali v e-poštni podpis

Preverjanje s QR kodo

Namenska stran za preverjanje prikazuje QR kodo, ki jo je mogoče skenirati in kaže na njen lasten URL — odlično za natisnjena potrdila, pasice na dogodkih ali posnetke zaslona z LinkedIna.

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

Kdor s kamero telefona skenira QR kodo, pristane na živi strani za preverjanje, kjer lahko potrdi, da je značka gostovana na badges.ninja in sledi specifikaciji Open Badge v2.0. Identiteta prejemnika je prikazana kot zgoščena vrednost SHA-256, tako da e-poštni naslovi nikoli niso javno razkriti.

PDF potrdilo

Vsako poverilnico je mogoče prenesti kot A4 PDF potrdilo, pripravljeno za tisk. Možnost Certificate je v spustnem meniju Download na javni strani poverilnice (/awards/{guid}) — ne na strani za preverjanje, ki vsebuje le QR kodo za skeniranje in surovi JSON Open Badge. Izbira te možnosti sproti ustvari PDF (na /certify-badge/award/{guid}/pdf) s sliko značke, imenom prejemnika, izdajateljem, merili, datumom izdaje, neobveznim datumom poteka in QR kodo, ki vodi nazaj na živi URL za preverjanje.

Predogledi na družbenih omrežjih

Ko je povezava do značke deljena na LinkedInu, X-u, Slacku, Facebooku, WhatsAppu ali po e-pošti, platforma pridobi končno točko za deljenje in iz metapodatkov Open Graph, ki jih oddaja badges.ninja, izriše bogato kartico:

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

Tako značke ob deljenju kjer koli delujejo profesionalno — prejemnikom ni treba pripeti lastne slike ali pisati besedila. Predogled se ustvari na strežniku na /certify-badge/award/{guid}/share-html in se predpomni na robu CDN, zato se predogledi prikažejo takoj, tudi ob prvem deljenju.

Deljenje po e-pošti

Poverilnice lahko pošljete po e-pošti 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, v katerega vnesejo enega ali več e-poštnih naslovov, neobvezen zadevek in osebno sporočilo:

Vsak naslovnik prejme oblikovano HTML e-pošto z osebnim sporočilom prejemnika in gumbom za ogled javne strani poverilnice z enim klikom:

Z nadzorne plošče

Izdajatelji lahko katero koli poverilnico pošljejo po e-pošti na strani Credentials na nadzorni plošči:

1. Poiščite poverilnico na strani Credentials.
2. Kliknite gumb Send v vrstici ali odprite podrobnostno okno in kliknite Resend email.
3. Vnesite e-poštni naslov prejemnika in pošljite.

Za oba načina se uporablja isto e-poštno predlogo.

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

Zaradi interoperabilnosti 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 trditve (poverilnica)

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 preverjanje poverilnic.

Primer — preverjanje poverilnice:

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-ji slik značk

Slike značk so shranjene na Amazon S3 in postrežene prek našega globalnega CDN pod vsebinsko naslovljenim, nespremenljivim URL-jem, izpeljanim iz kriptografske zgoščene vrednosti (SHA-256) bajtov slike. To pomeni:

• Slike so trajne in vsebinsko naslovljene — URL je izpeljan iz samih bajtov, zato jih ni mogoče potvoriti ali neopazno zamenjati
• URL-ji slik v JSON Open Badge izgledajo kot https://badges.ninja/images/{sha256}.png
• Slike se postrežejo z roba CDN, zato se povsod po svetu hitro naložijo in ostanejo na voljo ves čas veljavnosti poverilnice

Ker je slika del trditve Open Badge, poznejša zamenjava grafike značke ne pokvari že izdanih poverilnic: izvirna slika ohrani svoj vsebinsko naslovljeni URL, zato zgodovinske poverilnice ohranijo izvirno sliko, tudi če značko za nove izdaje preoblikujete.