Sdílení a ověřování

Každé udělení odznaku na badges.ninja má veřejnou ověřovací stránku, k níž má přístup kdokoli bez přihlášení. Příjemci mohou své odznaky sdílet na sociálních sítích, e-mailem nebo zkopírováním přímého odkazu.

Příjemci mají také vlastní portál

Pokud jste získali odznak prostřednictvím badges.ninja, můžete se přihlásit (bez hesla) na adrese badges.ninja/me a vidět všechny své odznaky na jednom místě a vytvořit veřejný profil na badges.ninja/u/<vase-handle>. Viz Portál příjemce.

Veřejná stránka udělení

Každé udělení má veřejnou URL adresu:

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

Tato stránka zobrazuje obrázek odznaku (načtený z IPFS), název a popis odznaku, jméno příjemce, název a logo vydavatele, datum vydání a případné datum vypršení platnosti a kritéria, která příjemce splnil, aby odznak získal. Kdokoli s odkazem může otevřít stránku a potvrdit, že je pověření pravé.

Pokud vydavatel nastavil LinkedIn organization ID, zobrazí se tlačítko Add to LinkedIn profile, takže příjemce může pověření uložit přímo do své sekce LinkedIn Licenses & Certifications. Tlačítko Download Badge poskytuje původní obrázek odznaku (přímo z IPFS) a Download PDF generuje na vyžádání certifikát A4 připravený k tisku.

Veřejná stránka pro sdílení

Stránka pro sdílení nabízí možnosti sdílení na sociálních sítích:

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

Z této stránky mohou příjemci svůj odznak sdílet na:

• LinkedIn — zveřejní příspěvek na jejich LinkedIn feedu nebo přidá pověření přímo do jejich profilu pomocí tlačítka Add to LinkedIn Profile (když vydavatel nastavil LinkedIn organization ID)
• Twitter / X — zveřejní tweet s odkazem na odznak a vlastním textem sdílení
• Facebook — sdílí na jejich Facebook timeline
• WhatsApp — odešle zprávu s odkazem na odznak
• Telegram — odešle zprávu s odkazem na odznak
• Send Email — otevře modální okno na stránce, které doručí stylizovaný e-mail jednomu nebo více příjemcům (viz Sdílení e-mailem níže)
• Copy Link — zkopíruje ověřovací URL do schránky
• Embed snippets — zkopíruje HTML <img> a <iframe> připravené ke vložení a umístění odznaku na webové stránky, intranet nebo do e-mailového podpisu

Ověření pomocí QR kódu

Vyhrazená ověřovací stránka vykreslí naskenovatelný QR kód odkazující na vlastní URL adresu — ideální pro tištěné certifikáty, bannery na akce nebo snímky obrazovky pro LinkedIn.

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

Kdokoli, kdo naskenuje QR kód kamerou telefonu, se dostane na živou ověřovací stránku, kde si může potvrdit, že odznak je hostován na badges.ninja, splňuje specifikaci Open Badge v2.0 a (na plánu Pro) je ukotven on-chain prostřednictvím Matchain. Identita příjemce je zobrazena jako hash SHA-256, takže e-maily nejsou nikdy veřejně vystaveny.

PDF certifikát

Každé udělení má na veřejné ověřovací stránce tlačítko Download Certificate. Kliknutím se na vyžádání vygeneruje PDF formátu A4 připravené k tisku, které obsahuje obrázek odznaku, jméno příjemce, vydavatele, kritéria, datum vydání, volitelné datum vypršení a QR kód odkazující zpět na živou ověřovací URL.

Náhledy na sociálních sítích

Když je odkaz na odznak sdílen na LinkedIn, X, Slack, Facebook, WhatsApp nebo v e-mailu, platforma načte share endpoint a vykreslí bohatou kartu z metadat Open Graph, která badges.ninja vysílá:

• Obrázek odznaku jako náhledový obrázek
• Název odznaku jako titulek
• Jméno vydavatele a jméno příjemce v popisu

Tím je zajištěno, že odznaky vypadají profesionálně, ať jsou sdíleny kdekoli — příjemci nemusí připojovat vlastní obrázek ani psát text. Náhled je generován na straně serveru na adrese /certify-badge/award/{guid}/share-html a ukládán do mezipaměti na CDN edge, takže náhledy se zobrazují okamžitě i při prvním sdílení.

Sdílení e-mailem

Udělení odznaků můžete posílat e-mailem dvěma způsoby:

Z veřejné stránky pro sdílení

Příjemci mohou svůj odznak sdílet s přáteli, mentory nebo potenciálními zaměstnavateli kliknutím na Send Email na stránce pro sdílení. Otevře se modální okno, kde zadají jednu nebo více e-mailových adres, volitelný předmět a osobní zprávu:

Každý adresát obdrží stylizovaný HTML e-mail s osobní zprávou příjemce a tlačítkem na jedno kliknutí pro zobrazení veřejné stránky udělení:

Z dashboardu

Vydavatelé mohou jakékoli udělení poslat e-mailem ze stránky Awards v dashboardu:

1. Najděte udělení na stránce Awards.
2. Klikněte na tlačítko Send v řádku nebo otevřete detailní modální okno a klikněte na Resend email.
3. Zadejte e-mail příjemce a odešlete.

Pro oba toky se používá stejná e-mailová šablona.

JSON koncové body Open Badge v2.0

Pro interoperabilitu s jinými platformami pro odznaky poskytuje badges.ninja standardní Open Badge v2.0 JSON na těchto veřejných endpointech:

Endpoint	Popis
/certify-badge/issuer/{guid}	JSON profilu vydavatele
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (udělení)

Tyto endpointy vracejí JSON-LD kompatibilní se specifikací Open Badge v2.0. Jiné platformy pro odznaky a verifikátory mohou tato data konzumovat k validaci pověření.

Příklad — ověření udělení:

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 URL adresy obrázků

Obrázky odznaků jsou připnuty na IPFS (the InterPlanetary File System) prostřednictvím naší vlastní brány ipfs.ninja. To znamená:

• Obrázky jsou trvalé a adresované obsahem — nelze je manipulovat ani tiše nahradit
• URL adresy obrázků v Open Badge JSON vypadají takto: https://ipfs.ninja/ipfs/{cid}
• Stejné content-ID se rozlišuje přes jakoukoli veřejnou IPFS bránu (cloudflare-ipfs.com, ipfs.io atd.) — vaše odznaky nejsou vázány na jednoho poskytovatele

Protože obrázek je součástí Open Badge assertion, pozdější nahrazení grafiky odznaku nezruší dříve udělené odznaky: staré IPFS CID zůstává navždy rozlišitelné, takže historická udělení si zachovávají svůj původní obrázek, i když odznak pro nová udělení přepracujete.