Dalijimasis ir patvirtinimas

Kiekvienas apdovanojimas badges.ninja platformoje turi viešą patvirtinimo puslapį, kurį gali pasiekti bet kas neprisijungęs. Gavėjai gali dalintis savo ženkleliais socialiniuose tinkluose, el. paštu arba nukopijavę tiesioginę nuorodą.

Gavėjai taip pat turi savo portalą

Jei gavote ženklelį per badges.ninja, galite prisijungti (slaptažodžio nereikia) adresu badges.ninja/me, kad matytumėte visus savo ženklelius vienoje vietoje ir kuruotumėte viešąjį profilį adresu badges.ninja/u/<jūsų-handle>. Žr. Gavėjo portalą.

Viešas apdovanojimo puslapis

Kiekvienas apdovanojimas turi viešą URL:

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

Šis puslapis rodo ženklelio paveikslėlį (įkeltą iš IPFS), ženklelio pavadinimą ir aprašymą, gavėjo vardą, leidėjo pavadinimą ir logotipą, išdavimo datą ir bet kokią galiojimo pabaigos datą, taip pat kriterijus, kuriuos gavėjas atitiko, kad gautų ženklelį. Bet kas, turintis nuorodą, gali atidaryti puslapį ir patvirtinti, kad kredencialas yra autentiškas.

Jei leidėjas nustatė LinkedIn organizacijos ID, atsiranda mygtukas Add to LinkedIn profile, kad gavėjas galėtų išsaugoti kredencialą tiesiai į savo LinkedIn licencijų ir sertifikatų skiltį. Mygtukas Download Badge pateikia originalų ženklelio paveikslėlį (tiesiai iš IPFS), o Download PDF akimirksniu sugeneruoja spausdinimui paruoštą A4 sertifikatą.

Viešas dalijimosi puslapis

Dalijimosi puslapyje pateikiamos socialinio dalijimosi parinktys:

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

Iš šio puslapio gavėjai gali pasidalinti savo ženkleliu šiose platformose:

• LinkedIn — paskelbti savo LinkedIn sraute arba pridėti kredencialą tiesiai į profilį naudojant mygtuką Add to LinkedIn Profile (kai leidėjas yra nustatęs LinkedIn organizacijos ID)
• Twitter / X — paskelbti tweet su ženklelio nuoroda ir pasirinktiniu dalijimosi tekstu
• Facebook — pasidalinti savo Facebook laiko juostoje
• WhatsApp — siųsti pranešimą su ženklelio nuoroda
• Telegram — siųsti pranešimą su ženklelio nuoroda
• Send Email — atidaro modalinį langą puslapyje, kuris pristato stilingą el. laišką vienam ar daugeliui gavėjų (žr. Dalijimasis el. paštu žemiau)
• Copy Link — nukopijuoja patvirtinimo URL į iškarpinę
• Embed snippets — nukopijuoja paruoštą įklijuoti <img> ir <iframe> HTML, kad galėtumėte įterpti ženklelį į svetainę, intranetą ar el. pašto parašą

QR patvirtinimas

Specialus patvirtinimo puslapis pateikia nuskaitomą QR kodą, nurodantį į savo paties URL — puikiai tinka spausdintiems sertifikatams, renginių baneriams ar LinkedIn ekrano nuotraukoms.

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

Bet kas, nuskaitantis QR su telefono kamera, patenka į gyvą patvirtinimo puslapį, kuriame gali patvirtinti, kad ženklelis priglobtas badges.ninja, atitinka Open Badge v2.0 specifikaciją ir (Pro plane) yra įtvirtintas grandinėje per Matchain. Gavėjo tapatybė rodoma kaip SHA-256 maišos kodas, todėl el. paštai niekada nėra viešai atskleidžiami.

PDF sertifikatas

Kiekvienas apdovanojimas turi mygtuką Download Certificate viešame patvirtinimo puslapyje. Spustelėjus jį, akimirksniu sugeneruojamas spausdinimui paruoštas A4 PDF, kuriame yra ženklelio paveikslėlis, gavėjo vardas, leidėjas, kriterijai, išdavimo data, neprivaloma galiojimo pabaiga ir QR kodas, vedantis atgal į gyvą patvirtinimo URL.

Socialinių tinklų peržiūros

Kai ženklelio nuoroda yra dalinama LinkedIn, X, Slack, Facebook, WhatsApp ar el. paštu, platforma gauna dalijimosi galinį tašką ir atvaizduoja praturtintą kortelę iš Open Graph metaduomenų, kuriuos badges.ninja išskleidžia:

• Ženklelio paveikslėlis kaip peržiūros vaizdas
• Ženklelio pavadinimas kaip antraštė
• Leidėjo pavadinimas ir gavėjo vardas aprašyme

Tai užtikrina, kad ženkleliai atrodo profesionaliai, kur jais bedalinsitės — gavėjams nereikia pridėti savo paveikslėlio ar rašyti teksto. Peržiūra generuojama serverio pusėje adresu /certify-badge/award/{guid}/share-html ir talpykloje saugoma CDN krašte, todėl peržiūros pasirodo akimirksniu net pirmajam dalijimuisi.

Dalijimasis el. paštu

Ženklelių apdovanojimus el. paštu galite siųsti dviem būdais:

Iš viešo dalijimosi puslapio

Gavėjai gali pasidalinti savo ženkleliu su draugais, mentoriais ar potencialiais darbdaviais spustelėdami Send Email dalijimosi puslapyje. Atidaromas modalinis langas, kuriame jie įveda vieną ar daugiau el. pašto adresų, neprivalomą temą ir asmeninę žinutę:

Kiekvienas adresatas gauna stilingą HTML el. laišką su gavėjo asmenine žinute ir vieno paspaudimo mygtuku, kad peržiūrėtų viešą apdovanojimo puslapį:

Iš prietaisų skydelio

Leidėjai gali siųsti bet kurį apdovanojimą el. paštu iš Awards puslapio prietaisų skydelyje:

1. Raskite apdovanojimą Awards puslapyje.
2. Spustelėkite mygtuką Send eilutėje arba atidarykite išsamų modalinį langą ir spustelėkite Resend email.
3. Įveskite gavėjo el. paštą ir išsiųskite.

Abiems srautams naudojamas tas pats el. laiško šablonas.

Open Badge v2.0 JSON galiniai taškai

Suderinamumui su kitomis ženklelių platformomis badges.ninja teikia standartinį Open Badge v2.0 JSON šiuose viešuose galiniuose taškuose:

Galinis taškas	Aprašymas
/certify-badge/issuer/{guid}	Leidėjo profilio JSON
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (apdovanojimas)

Šie galiniai taškai grąžina JSON-LD, atitinkantį Open Badge v2.0 specifikaciją. Kitos ženklelių platformos ir tikrintojai gali naudoti šiuos duomenis kredencialams patvirtinti.

Pavyzdys — patvirtinkite apdovanojimą:

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 paveikslėlių URL

Ženklelių paveikslėliai yra prisegti prie IPFS (InterPlanetary File System) per mūsų pačių vartus, ipfs.ninja. Tai reiškia:

• Paveikslėliai yra nuolatiniai ir adresuojami pagal turinį — jų negalima pakeisti ar tyliai pakeisti kitais
• Paveikslėlių URL Open Badge JSON faile atrodo kaip https://ipfs.ninja/ipfs/{cid}
• Tas pats turinio ID yra išsprendžiamas per bet kurį viešą IPFS vartų sąsają (cloudflare-ipfs.com, ipfs.io ir kt.) — jūsų ženkleliai nėra pririšti prie vieno tiekėjo

Kadangi paveikslėlis yra Open Badge assertion dalis, vėliau pakeitus ženklelio meninę vaizduotę, anksčiau išleisti apdovanojimai nesugadinami: senas IPFS CID lieka išsprendžiamas amžinai, todėl istoriniai apdovanojimai išlaiko savo originalų paveikslėlį net jei perprojektuosite ženklelį naujiems leidimams.