Megosztás és ellenőrzés

A badges.ninja oldalon minden díjnak van egy nyilvános ellenőrző oldala, amelyhez bárki bejelentkezés nélkül hozzáférhet. A kitüntetettek megoszthatják kitűzőiket a közösségi médiában, e-mailben, vagy egy közvetlen link másolásával.

A kitüntetetteknek is van saját portáljuk

Ha a badges.ninja-n keresztül szereztél kitűzőt, bejelentkezhetsz (jelszó nélkül) a badges.ninja/me címen, hogy az összes kitűződet egy helyen lásd, és nyilvános profilt hozz létre a badges.ninja/u/<azonosítód> címen. Lásd: Kitüntetett portál.

Nyilvános díj oldal

Minden díjnak van egy nyilvános URL-je:

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

Ez az oldal megjeleníti a kitűző képét (IPFS-ről betöltve), a kitűző nevét és leírását, a kitüntetett nevét, a kibocsátó nevét és logóját, a kibocsátás dátumát és az esetleges lejárati dátumot, valamint azokat a kritériumokat, amelyeket a kitüntetett teljesített a kitűző megszerzéséhez. Bárki, akinek megvan a link, megnyithatja az oldalt, hogy megerősítse a hitelesítő adat valódiságát.

Ha a kibocsátó megadott egy LinkedIn szervezeti azonosítót, megjelenik az Add to LinkedIn profile gomb, amellyel a kitüntetett közvetlenül a LinkedIn Licences & Certifications szakaszába mentheti a hitelesítő adatot. A Download Badge gomb az eredeti kitűzőképet szolgáltatja (közvetlenül az IPFS-ről), a Download PDF pedig azonnal létrehoz egy nyomtatható A4-es tanúsítványt.

Nyilvános megosztó oldal

A megosztó oldal közösségi megosztási lehetőségeket kínál:

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

Erről az oldalról a kitüntetettek megoszthatják kitűzőjüket a következő platformokon:

• LinkedIn — közzéteszi a LinkedIn hírfolyamban, vagy közvetlenül a profilhoz adja a hitelesítő adatot az Add to LinkedIn Profile gombbal (ha a kibocsátó megadott egy LinkedIn szervezeti azonosítót)
• Twitter / X — tweetet tesz közzé a kitűző linkjével és egyedi megosztási szöveggel
• Facebook — megosztja a Facebook idővonalukon
• WhatsApp — üzenetet küld a kitűző linkjével
• Telegram — üzenetet küld a kitűző linkjével
• Send Email — egy oldalon belüli modális ablakot nyit meg, amely stilizált e-mailt küld egy vagy több címzettnek (lásd alább: E-mail megosztás)
• Copy Link — az ellenőrző URL-t a vágólapra másolja
• Embed snippets — másolható, beilleszthető <img> és <iframe> HTML kódot biztosít a kitűző weboldalra, intranetre vagy e-mail aláírásba helyezéséhez

QR-ellenőrzés

Egy dedikált ellenőrző oldal megjelenít egy beolvasható QR-kódot, amely a saját URL-jére mutat — tökéletes nyomtatott tanúsítványokhoz, eseménybannerekhez vagy LinkedIn képernyőképekhez.

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

Bárki, aki telefonkamerával beolvassa a QR-t, az élő ellenőrző oldalra kerül, ahol megerősítheti, hogy a kitűzőt a badges.ninja tárolja, követi az Open Badge v2.0 specifikációt, és (a Pro csomagon) Matchain-en keresztül horgonyozva van a láncon. A kitüntetett személyazonosságát SHA-256 hash-ként jeleníti meg, így az e-mailek soha nem kerülnek nyilvánosan közzétételre.

PDF-tanúsítvány

Minden díjon megtalálható egy Download Certificate gomb a nyilvános ellenőrző oldalon. A gombra kattintva azonnal létrejön egy nyomtatásra kész A4-es PDF, amely tartalmazza a kitűző képét, a kitüntetett nevét, a kibocsátót, a kritériumokat, a kibocsátás dátumát, az opcionális lejáratot és egy QR-kódot, amely visszamutat az élő ellenőrző URL-re.

Közösségi média előnézetek

Amikor egy kitűző linket megosztanak a LinkedIn, X, Slack, Facebook, WhatsApp vagy e-mail platformon, a platform lekéri a megosztási végpontot, és gazdag kártyát jelenít meg a badges.ninja által kibocsátott Open Graph metaadatokból:

• A kitűző képe előnézeti képként
• A kitűző neve címként
• A kibocsátó neve és a kitüntetett neve a leírásban

Ez biztosítja, hogy a kitűzők professzionálisan néznek ki, bárhol is osztják meg őket — a kitüntetetteknek nem kell saját képet csatolniuk vagy szöveget írniuk. Az előnézetet szerver oldalon generáljuk a /certify-badge/award/{guid}/share-html címen és a CDN edge-en cache-eljük, így az előnézetek azonnal megjelennek már az első megosztáskor is.

E-mail megosztás

Két módon küldhetsz kitűződíjakat e-mailben:

A nyilvános megosztó oldalról

A kitüntetettek megoszthatják kitűzőjüket barátokkal, mentorokkal vagy potenciális munkáltatókkal a megosztó oldalon a Send Email gombra kattintva. Megnyílik egy modális ablak, ahol megadhatnak egy vagy több e-mail címet, egy opcionális tárgyat és egy személyes üzenetet:

Minden címzett egy stilizált HTML e-mailt kap a kitüntetett személyes üzenetével és egy egyetlen kattintásos gombbal a nyilvános díj oldal megtekintéséhez:

Az irányítópultról

A kibocsátók bármely díjat e-mailben elküldhetnek az irányítópult Awards oldaláról:

1. Keresd meg a díjat az Awards oldalon.
2. Kattints a sor Send gombjára, vagy nyisd meg a részletes modális ablakot, és kattints a Resend email gombra.
3. Add meg a címzett e-mail címét, és küldd el.

Mindkét folyamatban ugyanazt az e-mail sablont használjuk.

Open Badge v2.0 JSON végpontok

Más kitűzőplatformokkal való interoperabilitás érdekében a badges.ninja szabványos Open Badge v2.0 JSON-t biztosít ezeken a nyilvános végpontokon:

Végpont	Leírás
/certify-badge/issuer/{guid}	Kibocsátói profil JSON
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (a díj)

Ezek a végpontok az Open Badge v2.0 specifikációnak megfelelő JSON-LD-t adnak vissza. Más kitűzőplatformok és ellenőrzők felhasználhatják ezeket az adatokat a hitelesítő adatok érvényesítésére.

Példa — díj ellenőrzése:

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 képek URL-jei

A kitűzők képei az IPFS (InterPlanetary File System) hálózatra vannak rögzítve a saját átjárónk, az ipfs.ninja segítségével. Ez azt jelenti:

• A képek állandóak és tartalom-címzettek — nem manipulálhatók és nem cserélhetők ki csendben
• A képek URL-jei az Open Badge JSON-ban így néznek ki: https://ipfs.ninja/ipfs/{cid}
• Ugyanaz a tartalom-azonosító feloldódik bármely nyilvános IPFS átjárón keresztül (cloudflare-ipfs.com, ipfs.io, stb.) — a kitűzőid nincsenek egyetlen szolgáltatóhoz kötve

Mivel a kép az Open Badge assertion része, a kitűző grafikájának későbbi cseréje nem rontja el a korábban kiadott díjakat: a régi IPFS CID örökre feloldható marad, így a történelmi díjak megőrzik eredeti képüket akkor is, ha új kibocsátásokhoz újratervezed a kitűzőt.