Dalijimasis ir patikrinimas

Kiekvienas „badges.ninja“ įgyjamas patvirtinimas turi viešą patikrinimo puslapį, kurį gali atidaryti bet kas be prisijungimo. Gavėjai gali dalytis savo ženkleliais socialiniuose tinkluose, el. paštu arba nukopijuodami tiesioginę nuorodą.

Gavėjai turi ir savo portalą

Jei ženklelį gavote per badges.ninja, galite prisijungti (slaptažodžio nereikia) adresu badges.ninja/me, kad pamatytumėte visus savo ženklelius vienoje vietoje ir sukurtumėte viešą profilį adresu badges.ninja/u/<your-handle>. Žr. Gavėjo portalas.

Viešas patvirtinimo puslapis

Kiekvienas patvirtinimas turi viešą URL:

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

Šiame puslapyje rodomas skaitmeninio ženklelio vaizdas, pavadinimas ir aprašymas, gavėjo vardas, išdavėjo pavadinimas ir logotipas, išdavimo data ir galiojimo pabaigos data (jei yra), taip pat kriterijai, kuriuos gavėjas įvykdė gaudamas ženklelį. Kiekvienas, turintis nuorodą, gali atidaryti puslapį ir įsitikinti, kad patvirtinimas autentiškas.

Patvirtinimo puslapyje visada rodomas mygtukas Add to LinkedIn profile, kad gavėjas galėtų išsaugoti patvirtinimą tiesiai savo LinkedIn skiltyje „Licenses & Certifications“. (Jei išdavėjas nurodė LinkedIn organizacijos ID, LinkedIn iš anksto užpildo patvirtintą įmonės puslapį; kitu atveju naudojamas išdavėjo pavadinimas.) Vienas išskleidžiamasis meniu Atsisiųsti siūlo dvi parinktis: Ženklelio vaizdas (originalus PNG) ir Sertifikatas (spausdinamas A4 PDF, sugeneruojamas iš karto adresu /certify-badge/award/{guid}/pdf).

Viešas dalijimosi puslapis

Dalijimosi puslapyje pateikiamos socialinio dalijimosi parinktys:

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

Šiame puslapyje gavėjai gali pasidalyti savo ženkleliu:

• LinkedIn — paskelbia ženklelį jų LinkedIn sraute (jei norite patvirtinimą pridėti tiesiai į profilį, vietoj to naudokite mygtuką Add to LinkedIn profile patvirtinimo puslapyje)
• Twitter / X — paskelbia įrašą su ženklelio nuoroda ir pasirinktu dalijimosi tekstu
• Facebook — pasidalija Facebook laiko juostoje
• WhatsApp — išsiunčia žinutę su ženklelio nuoroda
• Telegram — išsiunčia žinutę su ženklelio nuoroda
• Siųsti el. laišką — atidaro puslapyje esantį modalinį langą, kuris išsiunčia stilizuotą el. laišką vienam ar keliems gavėjams (žr. Dalijimasis paštu toliau)
• Kopijuoti nuorodą — nukopijuoja patikrinimo URL į iškarpinę
• Įterpimo fragmentai — nukopijuokite paruoštą įklijuoti <img> ir <iframe> HTML, kad ženklelį įterptumėte svetainėje, intranete ar el. pašto parašė

QR patikrinimas

Specialus patikrinimo puslapis parodo nuskaitomą QR kodą, nukreipiantį į savo paties URL — puikiai tinka spausdintiems sertifikatams, renginių reklaminiams stendams ar LinkedIn ekrano nuotraukoms.

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

Kiekvienas, nuskaitęs QR kodą telefono kamera, patenka į tiesioginį patikrinimo puslapį, kuriame gali įsitikinti, kad ženklelis talpinamas badges.ninja ir atitinka Open Badge v2.0 specifikaciją. Gavėjo tapatybė rodoma kaip SHA-256 maiša, todėl el. pašto adresai niekada neatskleidžiami viešai.

PDF sertifikatas

Kiekvieną patvirtinimą galima atsisiųsti kaip spausdinimui paruoštą A4 PDF sertifikatą. Parinktis Sertifikatas yra išskleidžiamajame meniu Atsisiųsti viešame patvirtinimo puslapyje (/awards/{guid}) — o ne patikrinimo puslapyje, kuriame yra tik nuskaitomas QR kodas ir neapdorotas Open Badge JSON. Ją pasirinkus, PDF sugeneruojamas iš karto (adresu /certify-badge/award/{guid}/pdf) su ženklelio vaizdu, gavėjo vardu, išdavėju, kriterijais, išdavimo data, pasirinktine galiojimo pabaiga ir QR kodu, nukreipiančiu į tiesioginį patikrinimo URL.

Socialinių tinklų peržiūros

Kai ženklelio nuoroda bendrinama LinkedIn, X, Slack, Facebook, WhatsApp ar el. paštu, platforma gauna dalijimosi galinį tašką ir sukuria turtingą kortelę pagal Open Graph metaduomenis, kuriuos skelbia badges.ninja:

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

Taip ženklelis profesionaliai atrodo, kad ir kur juo dalytumėtės — gavėjams nereikia prisegti savo paveikslėlio ar rašyti teksto. Peržiūra generuojama serveryje adresu /certify-badge/award/{guid}/share-html ir talpinama CDN krašte, todėl peržiūros atsiranda iškart net pirmą kartą dalijantis.

Dalijimasis paštu

Patvirtinimus el. paštu galite siųsti dviem būdais:

Iš viešo dalijimosi puslapio

Gavėjai gali pasidalyti savo ženkleliu su draugais, mentoriais ar būsimais darbdaviais dalijimosi puslapyje spustelėję Siųsti el. laišką. Atsidaro modalinis langas, kuriame įvedami vienas ar keli el. pašto adresai, neprivaloma tema ir asmeninė žinutė:

Kiekvienas adresatas gauna stilizuotą HTML el. laišką su gavėjo asmenine žinute ir vieno paspaudimo mygtuku viešam patvirtinimo puslapiui peržiūrėti:

Iš skydelio

Išdavėjai gali išsiųsti bet kurį patvirtinimą el. paštu iš skydelio puslapio „Credentials“:

1. Suraskite patvirtinimą puslapyje „Credentials“.
2. Spustelėkite eilutės mygtuką Siųsti arba atidarykite išsamią informaciją ir spustelėkite Siųsti el. laišką dar kartą.
3. Įveskite gavėjo el. pašto adresą ir išsiųskite.

Abiem atvejais naudojamas tas pats el. laiško šablonas.

Open Badge v2.0 JSON galiniai taškai

Siekiant sąveikumo su kitomis ženklelių platformomis, badges.ninja teikia standartinį Open Badge v2.0 JSON šiais viešais galiniais taškais:

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

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

Pavyzdys — patvirtinimo patikrinimas:

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

Ženklelio vaizdų URL

Ženklelių vaizdai saugomi „Amazon S3“ ir pateikiami per mūsų pasaulinį CDN turinio adresu grindžiamu nekeičiamu URL, gautu iš vaizdo baitų kriptografinės maišos (SHA-256). Tai reiškia:

• Vaizdai yra nuolatiniai ir adresuojami pagal turinį — URL gaunamas iš pačių baitų, todėl jų negalima pakeisti ar tyliai pakeisti kitais
• Vaizdų URL Open Badge JSON atrodo taip: https://badges.ninja/images/{sha256}.png
• Vaizdai pateikiami iš CDN krašto, todėl greitai įkeliami bet kurioje pasaulio vietoje ir lieka prieinami visą patvirtinimo galiojimo laiką

Kadangi vaizdas yra Open Badge assertion dalis, vėlesnis ženklelio grafikos pakeitimas nesugadina anksčiau išduotų patvirtinimų: originalus vaizdas išlaiko savo turiniu grindžiamą URL, todėl ankstesni patvirtinimai išsaugo originalų vaizdą, net jei naujiems išdavimams ženklelį perprojektuojate.