Zdieľanie a overovanie

Každé udelenie na badges.ninja má verejnú overovaciu stránku, ku ktorej sa môže dostať 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 si získal odznak cez badges.ninja, môžeš sa prihlásiť (bez hesla) na badges.ninja/me, kde uvidíš všetky svoje odznaky na jednom mieste a vytvoríš si verejný profil na badges.ninja/u/<tvoj-handle>. Pozri Portál príjemcu.

Verejná stránka udelenia

Každé udelenie má verejnú URL adresu:

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

Táto stránka zobrazuje obrázok odznaku (načítaný z IPFS), názov a popis odznaku, meno príjemcu, názov a logo vydavateľa, dátum vydania a prípadný dátum platnosti, ako aj kritériá, ktoré príjemca splnil, aby odznak získal. Ktokoľvek s odkazom môže stránku otvoriť a potvrdiť, že poverenie je pravé.

Ak vydavateľ nastavil ID organizácie na LinkedIn, zobrazí sa tlačidlo Pridať do profilu LinkedIn, aby si príjemca mohol uložiť poverenie priamo do svojich Licencií a certifikácií na LinkedIn. Tlačidlo Stiahnuť odznak poskytuje pôvodný obrázok odznaku (priamo z IPFS) a Stiahnuť PDF na počkanie vygeneruje certifikát vo formáte A4 pripravený na tlač.

Verejná stránka na zdieľanie

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

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

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

• LinkedIn — zverejní príspevok v ich LinkedIn feede alebo pridá poverenie priamo do profilu cez tlačidlo Add to LinkedIn Profile (ak vydavateľ nastavil ID organizácie na LinkedIn)
• Twitter / X — zverejní tweet s odkazom na odznak a vlastným textom
• Facebook — zdieľa na ich časovej osi na Facebooku
• WhatsApp — pošle správu s odkazom na odznak
• Telegram — pošle správu s odkazom na odznak
• Send Email — otvorí modálne okno priamo na stránke, ktoré odošle vyštýlovaný e-mail jednému alebo viacerým adresátom (pozri Zdieľanie e-mailom nižšie)
• Copy Link — skopíruje URL na overenie do schránky
• Embed snippets — skopíruje pripravený HTML (<img> a <iframe>) na vloženie odznaku na webovú stránku, intranet alebo do e-mailového podpisu

Overenie cez QR

Samostatná overovacia stránka zobrazuje naskenovateľný QR kód smerujúci na vlastnú URL — ideálne pre tlačené certifikáty, bannery na podujatiach alebo screenshoty pre LinkedIn.

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

Ktokoľvek, kto QR naskenuje fotoaparátom telefónu, sa dostane na živú overovaciu stránku, kde si môže potvrdiť, že odznak je hostovaný na badges.ninja, dodržiava špecifikáciu Open Badge v2.0 a (v pláne Pro) je ukotvený on-chain cez Matchain. Identita príjemcu sa zobrazuje ako hash SHA-256, takže e-mailové adresy nie sú nikdy verejne odhalené.

PDF certifikát

Každé udelenie má na verejnej overovacej stránke tlačidlo Download Certificate. Po kliknutí sa na počkanie vygeneruje PDF formátu A4 pripravené na tlač, ktoré obsahuje obrázok odznaku, meno príjemcu, vydavateľa, kritériá, dátum vydania, voliteľnú platnosť a QR kód odkazujúci späť na živú overovaciu URL.

Náhľady v sociálnych sieťach

Keď je odkaz na odznak zdieľaný na LinkedIn, X, Slacku, Facebooku, WhatsApp alebo e-mailom, daná platforma si vyžiada zdieľací endpoint a vykreslí bohatú kartu z metadát Open Graph, ktoré badges.ninja vydáva:

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

Takto odznaky pôsobia profesionálne všade, kde sú zdieľané — príjemcovia nemusia pripájať vlastný obrázok ani písať text. Náhľad sa generuje na strane servera na adrese /certify-badge/award/{guid}/share-html a je cachovaný na okraji CDN, takže náhľady sa zobrazia okamžite už pri prvom zdieľaní.

Zdieľanie e-mailom

Udelenia môžeš posielať e-mailom dvoma spôsobmi:

Z verejnej 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 zdieľania. Otvorí sa modálne okno, kde zadajú jednu alebo viac e-mailových adries, voliteľný predmet a osobnú správu:

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

Z dashboardu

Vydavatelia môžu poslať akékoľvek udelenie e-mailom zo stránky Awards v dashboarde:

1. Nájdi udelenie na stránke Awards.
2. Klikni na tlačidlo Send v riadku alebo otvor detailové modálne okno a klikni na Resend email.
3. Zadaj e-mailovú adresu príjemcu a odošli.

V oboch tokoch sa používa rovnaká e-mailová šablóna.

JSON endpointy Open Badge v2.0

Na zabezpečenie interoperability s inými platformami pre odznaky badges.ninja poskytuje štandardný Open Badge v2.0 JSON na týchto verejných endpointoch:

Endpoint	Popis
/certify-badge/issuer/{guid}	JSON profilu vydavateľa
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (udelenie)

Tieto endpointy vracajú JSON-LD v súlade so špecifikáciou Open Badge v2.0. Iné platformy pre odznaky a overovatelia môžu tieto údaje použiť na overenie poverení.

Príklad — overenie udelenia:

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 adresy obrázkov v IPFS

Obrázky odznakov sú pripnuté v IPFS (InterPlanetary File System) cez našu vlastnú bránu ipfs.ninja. To znamená, že:

• Obrázky sú trvalé a adresované obsahom — nemožno ich pozmeniť ani potichu nahradiť
• URL obrázkov v Open Badge JSON vyzerajú ako https://ipfs.ninja/ipfs/{cid}
• To isté content-ID sa rozlíši cez ľubovoľnú verejnú IPFS bránu (cloudflare-ipfs.com, ipfs.io atď.) — tvoje odznaky nie sú viazané na jediného poskytovateľa

Keďže obrázok je súčasťou Open Badge assertion, neskoršia výmena grafiky odznaku nepokazí už vydané udelenia: staré IPFS CID zostane navždy rozlíšiteľné, takže historické udelenia si zachovajú svoj pôvodný obrázok aj vtedy, ak odznak pre nové vydania prepracuješ.