Partajare și verificare

Fiecare premiere de pe badges.ninja are o pagină publică de verificare pe care oricine o poate accesa fără să se autentifice. Beneficiarii își pot partaja insignele pe rețelele sociale, prin e-mail sau copiind un link direct.

Beneficiarii au și ei propriul portal

Dacă ai obținut o insignă prin badges.ninja, te poți autentifica (fără parolă) la badges.ninja/me pentru a-ți vedea toate insignele într-un singur loc și pentru a-ți construi un profil public la badges.ninja/u/<handle-ul-tău>. Vezi Portalul beneficiarului.

Pagina publică a premierii

Fiecare premiere are un URL public:

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

Această pagină afișează imaginea insignei (încărcată din IPFS), numele și descrierea insignei, numele beneficiarului, numele și logo-ul emitentului, data emiterii și o eventuală dată de expirare, precum și criteriile pe care beneficiarul le-a îndeplinit pentru a obține insigna. Oricine deține linkul poate deschide pagina pentru a confirma că acreditarea este autentică.

Dacă emitentul a setat un ID de organizație LinkedIn, apare butonul Adaugă la profilul LinkedIn, astfel încât beneficiarul să poată salva acreditarea direct în secțiunea Licențe și Certificări din LinkedIn. Butonul Descarcă insigna servește imaginea originală a insignei (direct din IPFS), iar Descarcă PDF generează pe loc un certificat A4 gata de tipărit.

Pagina publică de partajare

Pagina de partajare oferă opțiuni de distribuire pe rețelele sociale:

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

De pe această pagină, beneficiarii își pot partaja insigna pe:

• LinkedIn — publică în fluxul lor LinkedIn sau adaugă acreditarea direct în profil prin butonul Add to LinkedIn Profile (atunci când emitentul a setat un ID de organizație LinkedIn)
• Twitter / X — publică un tweet cu linkul insignei și un text de partajare personalizat
• Facebook — distribuie pe cronologia lor Facebook
• WhatsApp — trimite un mesaj cu linkul insignei
• Telegram — trimite un mesaj cu linkul insignei
• Send Email — deschide un modal în pagină care livrează un e-mail stilizat către unul sau mai mulți destinatari (vezi Partajare prin e-mail mai jos)
• Copy Link — copiază URL-ul de verificare în clipboard
• Embed snippets — copiază HTML gata de lipit (<img> și <iframe>) pentru a insera insigna într-un site, intranet sau semnătură de e-mail

Verificare prin cod QR

O pagină dedicată de verificare afișează un cod QR scanabil care indică propriul URL — perfect pentru certificate tipărite, bannere de eveniment sau capturi de ecran pentru LinkedIn.

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

Oricine scanează codul QR cu camera telefonului ajunge pe pagina de verificare în timp real, unde poate confirma că insigna este găzduită pe badges.ninja, respectă specificația Open Badge v2.0 și (în planul Pro) este ancorată on-chain prin Matchain. Identitatea beneficiarului este afișată ca hash SHA-256, astfel încât adresele de e-mail să nu fie niciodată expuse public.

Certificat PDF

Fiecare premiere are un buton Download Certificate pe pagina publică de verificare. Apăsându-l, se generează pe loc un PDF A4 gata de tipărit, care include imaginea insignei, numele beneficiarului, emitentul, criteriile, data emiterii, expirarea opțională și un cod QR ce trimite înapoi la URL-ul de verificare în timp real.

Previzualizări pe rețelele sociale

Când un link de insignă este partajat pe LinkedIn, X, Slack, Facebook, WhatsApp sau e-mail, platforma respectivă apelează endpoint-ul de partajare și afișează un card bogat pe baza metadatelor Open Graph emise de badges.ninja:

• Imaginea insignei ca imagine de previzualizare
• Numele insignei ca titlu
• Numele emitentului și numele beneficiarului în descriere

Astfel, insignele arată profesionist oriunde sunt partajate — beneficiarii nu trebuie să atașeze propria imagine sau să scrie un text. Previzualizarea este generată pe server la /certify-badge/award/{guid}/share-html și este memorată în cache la marginea CDN, astfel încât previzualizările apar instantaneu chiar de la prima partajare.

Partajare prin e-mail

Poți trimite premieri prin e-mail în două moduri:

Din pagina publică de partajare

Beneficiarii își pot partaja insigna cu prieteni, mentori sau potențiali angajatori apăsând Send Email pe pagina de partajare. Se deschide un modal unde introduc una sau mai multe adrese de e-mail, un subiect opțional și un mesaj personal:

Fiecare destinatar primește un e-mail HTML stilizat cu mesajul personal al beneficiarului și un buton cu un singur clic pentru a deschide pagina publică a premierii:

Din panoul de administrare

Emitenții pot trimite orice premiere prin e-mail din pagina Awards a panoului:

1. Găsește premierea pe pagina Awards.
2. Apasă butonul Send de pe rând sau deschide modalul de detalii și apasă Resend email.
3. Introdu adresa de e-mail a destinatarului și trimite.

Același șablon de e-mail este folosit pentru ambele fluxuri.

Endpoint-uri JSON Open Badge v2.0

Pentru interoperabilitate cu alte platforme de insigne, badges.ninja oferă JSON Open Badge v2.0 standard la aceste endpoint-uri publice:

Endpoint	Descriere
/certify-badge/issuer/{guid}	JSON-ul profilului emitentului
/certify-badge/badge/{guid}	JSON-ul BadgeClass
/certify-badge/award/{guid}	JSON-ul Assertion (premierea)

Aceste endpoint-uri returnează JSON-LD compatibil cu specificația Open Badge v2.0. Alte platforme de insigne și verificatori pot consuma aceste date pentru a valida acreditările.

Exemplu — verificarea unei premieri:

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-uri de imagini IPFS

Imaginile insignelor sunt fixate pe IPFS (InterPlanetary File System) prin propriul nostru gateway, ipfs.ninja. Asta înseamnă că:

• Imaginile sunt permanente și adresate prin conținut — nu pot fi modificate sau înlocuite în secret
• URL-urile imaginilor în JSON-ul Open Badge arată ca https://ipfs.ninja/ipfs/{cid}
• Același content-ID se rezolvă prin orice gateway IPFS public (cloudflare-ipfs.com, ipfs.io etc.) — insignele tale nu sunt blocate la un singur furnizor

Deoarece imaginea face parte din assertion-ul Open Badge, înlocuirea ulterioară a graficii insignei nu strică premierile deja emise: vechiul CID IPFS rămâne rezolvabil pentru totdeauna, astfel încât premierile istorice își păstrează imaginea originală chiar dacă redesenezi insigna pentru noi emisiuni.