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

Každé pověření 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 pověření

Každé pověření 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. Identita příjemce je zobrazena jako hash SHA-256, takže e-maily nejsou nikdy veřejně vystaveny.

PDF certifikát

Každé pověření 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

Pověření 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 pověření:

Z dashboardu

Vydavatelé mohou jakékoli pověření poslat e-mailem ze stránky Credentials v dashboardu:

1. Najděte pověření na stránce Credentials.
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 (pověření)

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í pověření:

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 vydané odznaky: staré IPFS CID zůstává navždy rozlišitelné, takže historická pověření si zachovávají svůj původní obrázek, i když odznak pro nová vydání přepracujete.