Megosztás és ellenőrzés

A badges.ninja minden hitelesítő adatának van nyilvános ellenőrzőoldala, amelyet bárki megnyithat bejelentkezés nélkül. A kedvezményezettek megoszthatják jelvényeiket a közösségi médiában, e-mailben, vagy közvetlen hivatkozás másolásával.

A kedvezményezetteknek saját portáljuk is van

Ha jelvényt szereztél a badges.ninja-n keresztül, bejelentkezhetsz (jelszó nélkül) a badges.ninja/me oldalon, hogy egy helyen lásd az összes jelvényedet, és összeállíthass egy nyilvános profilt a badges.ninja/u/<your-handle> címen. Lásd: Kedvezményezetti portál.

Nyilvános hitelesítőadat-oldal

Minden hitelesítő adatnak van egy nyilvános URL-je:

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

Az oldal megjeleníti a jelvény képét, nevét és leírását, a kedvezményezett 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 feltételeket, amelyeket a kedvezményezett teljesített a jelvény megszerzéséhez. Bárki, aki rendelkezik a hivatkozással, megnyithatja az oldalt, hogy megerősítse a hitelesítő adat valódiságát.

A hitelesítőadat-oldalon mindig megjelenik az Add to LinkedIn profile gomb, így a kedvezményezett közvetlenül elmentheti a hitelesítő adatot a LinkedIn Licenses & Certifications szakaszába. (Ha a kibocsátó megadott LinkedIn organization ID-t, a LinkedIn előre kitölti az ellenőrzött céges oldalt; ellenkező esetben a kibocsátó nevét használja.) Egyetlen Letöltés legördülő menü két lehetőséget kínál: Jelvény képe (az eredeti PNG) és Tanúsítvány (nyomtatásra kész A4 PDF, amely menet közben jön létre a /certify-badge/award/{guid}/pdf címen).

Nyilvános megosztási oldal

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

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

Ezen az oldalon a kedvezményezettek a következő helyeken oszthatják meg jelvényüket:

• LinkedIn — kiposztolja a jelvényt a LinkedIn hírfolyamukba (ha a hitelesítő adatot közvetlenül a profilhoz szeretnéd adni, használd inkább a hitelesítőadat-oldal Add to LinkedIn profile gombját)
• Twitter / X — tweetet tesz közzé a jelvény hivatkozásával és egyedi megosztási szöveggel
• Facebook — megosztja a Facebook-idővonalukon
• WhatsApp — üzenetet küld a jelvény hivatkozásával
• Telegram — üzenetet küld a jelvény hivatkozásával
• E-mail küldése — az oldalon belüli modális ablakot nyit, amely stílusos e-mailt kézbesít egy vagy több címzettnek (lásd lejjebb: Megosztás e-mailben)
• Hivatkozás másolása — a vágólapra másolja az ellenőrző URL-t
• Beágyazási kódrészletek — másolj ki beillesztésre kész <img> és <iframe> HTML-t, hogy a jelvényt weboldalra, intranetre vagy e-mail-aláírásba helyezhesd

QR-ellenőrzés

Egy külön ellenőrzőoldal beolvasható QR-kódot jelenít meg, amely a saját URL-jére mutat — ideális nyomtatott tanúsítványokhoz, rendezvényplakátokhoz vagy LinkedIn-képernyőképekhez.

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

Aki telefonkamerával beolvassa a QR-kódot, az élő ellenőrzőoldalra jut, ahol megerősítheti, hogy a jelvény a badges.ninja-n van tárolva, és megfelel az Open Badge v2.0 specifikációnak. A kedvezményezett azonosítója SHA-256 hashként jelenik meg, így az e-mail-címek soha nem kerülnek nyilvánosságra.

PDF-tanúsítvány

Minden hitelesítő adat letölthető nyomtatásra kész A4 PDF-tanúsítványként. A Tanúsítvány lehetőség a nyilvános hitelesítőadat-oldal (/awards/{guid}) Letöltés legördülő menüjében található — nem az ellenőrzőoldalon, amely csak a beolvasható QR-kódot és a nyers Open Badge JSON-t tartalmazza. Kiválasztásakor a PDF menet közben jön létre (a /certify-badge/award/{guid}/pdf címen) a jelvény képével, a kedvezményezett nevével, a kibocsátóval, a feltételekkel, a kibocsátás dátumával, az opcionális lejárati dátummal, valamint egy QR-kóddal, amely az élő ellenőrző URL-re mutat.

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

Amikor egy jelvényhivatkozást megosztanak LinkedIn-en, X-en, Slacken, Facebookon, WhatsAppon vagy e-mailben, a platform lekéri a megosztási végpontot, és a badges.ninja által kiadott Open Graph metaadatokból gazdag kártyát jelenít meg:

• A jelvény képe előnézeti képként
• A jelvény neve címként
• A kibocsátó és a kedvezményezett neve a leírásban

Ezáltal a jelvények bárhol megosztva professzionálisan mutatnak — a kedvezményezetteknek nem kell saját képet csatolniuk vagy szöveget írniuk. Az előnézet szerveroldalon jön létre a /certify-badge/award/{guid}/share-html címen, és a CDN peremén gyorsítótárazódik, így az előnézetek már az első megosztáskor azonnal megjelennek.

Megosztás e-mailben

A hitelesítő adatokat két módon küldheted el e-mailben:

A nyilvános megosztási oldalról

A kedvezményezettek barátaikkal, mentoraikkal vagy leendő munkaadóikkal oszthatják meg jelvényüket a megosztási oldalon az E-mail küldése 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 stílusos HTML e-mailt kap a kedvezményezett személyes üzenetével és egy gombbal, amely egy kattintással a nyilvános hitelesítőadat-oldalra visz:

Az irányítópultról

A kibocsátók bármely hitelesítő adatot elküldhetnek e-mailben az irányítópult Hitelesítő adatok oldaláról:

1. Keresd meg a hitelesítő adatot a Hitelesítő adatok oldalon.
2. Kattints a sorban lévő Küldés gombra, vagy nyisd meg a részletek modális ablakát, és kattints az E-mail újraküldése gombra.
3. Add meg a kedvezményezett e-mail-címét, és küldd el.

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

Open Badge v2.0 JSON végpontok

A más jelvényplatformokkal való átjárhatóság é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 hitelesítő adat)

Ezek a végpontok az Open Badge v2.0 specifikációnak megfelelő JSON-LD-t adnak vissza. Más jelvényplatformok és ellenőrzők ezeket az adatokat felhasználhatják a hitelesítő adatok validálására.

Példa — hitelesítő adat 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"
  }
}

Jelvényképek URL-jei

A jelvényképeket az Amazon S3 tárolja, és globális CDN-ünkön keresztül szolgáljuk ki tartalomalapú, megváltoztathatatlan URL alatt, amelyet a kép bájtjainak kriptográfiai hashéből (SHA-256) származtatunk. Ez azt jelenti:

• A képek állandóak és tartalomalapúak — az URL magukból a bájtokból származik, így nem lehet őket manipulálni vagy észrevétlenül lecserélni
• A képek URL-jei az Open Badge JSON-ban így néznek ki: https://badges.ninja/images/{sha256}.png
• A képeket a CDN pereméről szolgáljuk ki, így a világ bármely pontján gyorsan betöltődnek, és a hitelesítő adat teljes élettartama alatt elérhetők maradnak

Mivel a kép az Open Badge assertion része, a jelvény grafikájának későbbi cseréje nem töri meg a korábban kiadott hitelesítő adatokat: az eredeti kép megtartja saját tartalomalapú URL-jét, így a korábbi hitelesítő adatok az eredeti képet őrzik akkor is, ha az új kibocsátásokhoz újratervezed a jelvényt.