Zdieľanie a overenie

Každý poverovací doklad (credential) na badges.ninja má verejnú stránku overenia, ku ktorej má prístup ktokoľvek bez prihlásenia. Príjemcovia môžu svoje odznaky zdieľať na sociálnych sieťach, e-mailom alebo skopírovaním priameho odkazu.

Príjemcovia majú aj vlastný portál

Ak ste získali odznak cez badges.ninja, môžete sa (bez hesla) prihlásiť na badges.ninja/me, kde uvidíte všetky svoje odznaky na jednom mieste a môžete si vytvoriť verejný profil na badges.ninja/u/<your-handle>. Pozrite si Portál príjemcu.

Verejná stránka credentialu

Každý credential má verejnú URL adresu:

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

Táto stránka zobrazuje obrázok odznaku, jeho názov a popis, meno príjemcu, názov a logo vydavateľa, dátum vydania a prípadný dátum skončenia platnosti, ako aj kritériá, ktoré príjemca splnil na získanie odznaku. Ktokoľvek s odkazom môže stránku otvoriť a overiť, že credential je pravý.

Stránka credentialu vždy zobrazuje tlačidlo Add to LinkedIn profile, aby si príjemca mohol credential uložiť priamo do sekcie Licenses & Certifications na LinkedIne. (Ak vydavateľ nastavil ID organizácie na LinkedIne, LinkedIn predvyplní overenú firemnú stránku; inak použije názov vydavateľa.) Jediná rozbaľovacia ponuka Download ponúka dve možnosti: Badge image (pôvodný PNG) a Certificate (tlačiteľné PDF vo formáte A4 generované za chodu na /certify-badge/award/{guid}/pdf).

Verejná stránka na zdieľanie

Stránka na zdieľanie ponúka možnosti zdieľania na sociálnych sieťach:

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

Z tejto stránky môžu príjemcovia svoj odznak zdieľať na:

• LinkedIn — uverejní odznak v ich kanáli na LinkedIne (ak chcete credential pridať priamo do profilu, použite namiesto toho tlačidlo Add to LinkedIn profile na stránke credentialu)
• Twitter / X — uverejní tweet s odkazom na odznak a vlastným textom
• Facebook — zdieľa na ich časovej osi na Facebooku
• WhatsApp — odošle správu s odkazom na odznak
• Telegram — odošle správu s odkazom na odznak
• Send Email — otvorí modálne okno na stránke, ktoré doručí štylizovaný e-mail jednému alebo viacerým adresátom (pozrite si Zdieľanie e-mailom nižšie)
• Copy Link — skopíruje overovaciu URL do schránky
• Úryvky na vloženie — skopírujte hotový HTML kód <img> a <iframe> na vloženie odznaku na webovú stránku, do intranetu alebo do e-mailového podpisu

Overenie cez QR kód

Samostatná stránka overenia zobrazuje naskenovateľný QR kód smerujúci na jej vlastnú URL — ideálne pre vytlačené certifikáty, banery na podujatiach alebo snímky obrazovky pre LinkedIn.

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

Ktokoľvek, kto naskenuje QR kód fotoaparátom telefónu, sa dostane na aktuálnu stránku overenia, kde môže potvrdiť, že odznak je hostovaný na badges.ninja a zodpovedá špecifikácii Open Badge v2.0. Identita príjemcu sa zobrazuje ako hash SHA-256, takže e-mailové adresy nikdy nie sú verejne odhalené.

PDF certifikát

Každý credential si možno stiahnuť ako PDF certifikát vo formáte A4 pripravený na tlač. Možnosť Certificate sa nachádza v rozbaľovacej ponuke Download na verejnej stránke credentialu (/awards/{guid}) — nie na stránke overenia, ktorá obsahuje iba naskenovateľný QR kód a surový JSON Open Badge. Po jej výbere sa PDF vygeneruje za chodu (na /certify-badge/award/{guid}/pdf) a obsahuje obrázok odznaku, meno príjemcu, vydavateľa, kritériá, dátum vydania, voliteľné skončenie platnosti a QR kód odkazujúci na aktuálnu overovaciu URL.

Ukážky na sociálnych sieťach

Keď sa odkaz na odznak zdieľa na LinkedIne, X, Slacku, Facebooku, WhatsAppe alebo e-mailom, platforma načíta koncový bod zdieľania a z metadát Open Graph, ktoré badges.ninja poskytuje, zobrazí bohatú kartu:

• Obrázok odznaku ako náhľadový obrázok
• Názov odznaku ako titulok
• Meno vydavateľa a meno príjemcu v popise

Vďaka tomu odznaky pôsobia profesionálne všade, kde sa zdieľajú — príjemcovia nemusia pripájať vlastný obrázok ani písať text. Náhľad sa generuje na strane servera na /certify-badge/award/{guid}/share-html a ukladá sa do vyrovnávacej pamäte na okraji CDN, takže sa zobrazí okamžite aj pri prvom zdieľaní.

Zdieľanie e-mailom

Credentialy môžete posielať e-mailom dvoma spôsobmi:

Zo stránky na zdieľanie

Príjemcovia môžu svoj odznak zdieľať s priateľmi, mentormi alebo potenciálnymi zamestnávateľmi kliknutím na Send Email na stránke na zdieľanie. Otvorí sa modálne okno, v ktorom zadajú jednu alebo viac e-mailových adries, voliteľný predmet a osobnú správu:

Každý adresát dostane štylizovaný HTML e-mail s osobnou správou príjemcu a tlačidlom na jedno kliknutie, ktoré otvorí verejnú stránku credentialu:

Z ovládacieho panela

Vydavatelia môžu ľubovoľný credential odoslať e-mailom zo stránky Credentials v ovládacom paneli:

1. Nájdite credential na stránke Credentials.
2. Kliknite na tlačidlo Send v riadku alebo otvorte detailné okno a kliknite na Resend email.
3. Zadajte e-mailovú adresu príjemcu a odošlite.

V oboch prípadoch sa používa rovnaká šablóna e-mailu.

Koncové body JSON Open Badge v2.0

Kvôli interoperabilite s inými platformami odznakov poskytuje badges.ninja štandardný JSON Open Badge v2.0 na týchto verejných koncových bodoch:

Koncový bod	Popis
/certify-badge/issuer/{guid}	JSON profilu vydavateľa
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (credential)

Tieto koncové body vracajú JSON-LD v súlade so špecifikáciou Open Badge v2.0. Iné platformy odznakov a overovacie nástroje môžu tieto údaje použiť na validáciu credentialov.

Príklad — overenie credentialu:

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 obrázkov odznakov

Obrázky odznakov sú uložené na Amazon S3 a poskytované cez našu globálnu CDN pod nemennou URL adresou odvodenou od obsahu, ktorá vychádza z kryptografického hashu (SHA-256) bajtov obrázka. To znamená, že:

• Obrázky sú trvalé a adresované obsahom — URL sa odvodzuje zo samotných bajtov, takže ich nemožno sfalšovať ani nepozorovane nahradiť
• URL obrázkov v JSON Open Badge vyzerajú takto: https://badges.ninja/images/{sha256}.png
• Obrázky sa poskytujú z okraja CDN, takže sa rýchlo načítajú kdekoľvek na svete a zostávajú dostupné počas celej životnosti credentialu

Keďže obrázok je súčasťou assertionu Open Badge, neskoršia výmena grafiky odznaku neovplyvní už vydané credentialy: pôvodný obrázok si zachová vlastnú URL odvodenú od obsahu, takže staršie credentialy si ponechajú pôvodný obrázok, aj keď odznak pre nové vydania prerobíte.