Jagamine ja kontroll

Igal badges.ninja autasul on avalik kontrolli-leht, millele igaüks saab sisse logimata juurde pääseda. Saajad saavad oma märke jagada sotsiaalmeedias, e-posti teel või otselinki kopeerides.

Saajatel on ka oma portaal

Kui oled teeninud märgi badges.ninja kaudu, saad sisse logida (parooli pole vaja) aadressil badges.ninja/me, et näha kõiki oma märke ühes kohas ja hallata avalikku profiili aadressil badges.ninja/u/<sinu-handle>. Vaata Saaja portaal.

Avalik autasu leht

Igal autasul on avalik URL:

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

See leht kuvab märgi pildi (laaditud IPFS-ist), märgi nime ja kirjelduse, saaja nime, väljaandja nime ja logo, väljaandmise kuupäeva ja võimaliku aegumise kuupäeva ning kriteeriumid, mille saaja täitis märgi teenimiseks. Igaüks, kellel on link, saab lehe avada, et veenduda mandaadi ehtsuses.

Kui väljaandja on määranud LinkedIni organisatsiooni ID, ilmub nupp Add to LinkedIn profile, et saaja saaks mandaadi otse oma LinkedIni litsentsidesse ja sertifikaatidesse salvestada. Nupp Download Badge edastab originaalse märgi pildi (otse IPFS-ist) ja Download PDF genereerib lennult prinditava A4-sertifikaadi.

Avalik jagamise leht

Jagamise leht pakub sotsiaalse jagamise valikuid:

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

Sellelt lehelt saavad saajad oma märki jagada platvormidel:

• LinkedIn — postitab nende LinkedIni voogu või lisab mandaadi otse profiilile nupu Add to LinkedIn Profile kaudu (kui väljaandja on määranud LinkedIni organisatsiooni ID)
• Twitter / X — postitab säutsu märgi lingi ja kohandatud jagamistekstiga
• Facebook — jagab Facebooki ajajoonel
• WhatsApp — saadab sõnumi märgi lingiga
• Telegram — saadab sõnumi märgi lingiga
• Send Email — avab lehel akna, mis edastab stiilse e-kirja ühele või paljudele saajatele (vaata E-posti jagamine allpool)
• Copy Link — kopeerib kontrolli-URL-i lõikelauale
• Embed snippets — kopeerib valmis kleepimiseks <img> ja <iframe> HTML-i, et lisada märk veebisaidile, sisevõrku või e-posti allkirja

QR-kontroll

Spetsiaalne kontrolli-leht renderdab skannitava QR-koodi, mis osutab tema enda URL-ile — ideaalne prinditud sertifikaatidele, ürituste bänneritele või LinkedIni ekraanitõmmistele.

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

Kõik, kes skannivad QR-koodi telefoni kaameraga, jõuavad otseülekande kontrolli-lehele, kus saab kinnitada, et märk on majutatud aadressil badges.ninja, järgib Open Badge v2.0 spetsifikatsiooni ja (Pro plaaniga) on Matchaini kaudu plokiahelas ankurdatud. Saaja identiteet kuvatakse SHA-256 räsina, nii et e-posti aadresse ei avalikustata kunagi.

PDF-sertifikaat

Igal autasul on avalikul kontrolli-lehel nupp Download Certificate. Sellele klõpsamine genereerib lennult prindivalmis A4 PDF-i, mis sisaldab märgi pilti, saaja nime, väljaandjat, kriteeriume, väljaandmise kuupäeva, valikulist aegumist ja QR-koodi, mis viib tagasi otseülekande kontrolli-URL-ile.

Sotsiaalmeedia eelvaated

Kui märgi linki jagatakse LinkedInis, X-is, Slackis, Facebookis, WhatsAppis või e-posti teel, küsib platvorm jagamise lõpp-punkti ja renderdab rikastatud kaardi Open Graph metaandmetest, mida badges.ninja edastab:

• Märgi pilt eelvaate pildina
• Märgi nimi pealkirjana
• Väljaandja nimi ja saaja nimi kirjelduses

See tagab, et märgid näevad kõikjal jagamisel professionaalsed välja — saajad ei pea oma pilti lisama ega teksti kirjutama. Eelvaade genereeritakse serveripoolselt aadressil /certify-badge/award/{guid}/share-html ja vahemällu salvestatakse CDN-i serval, nii et eelvaated ilmuvad kohe ka esimese jagamise korral.

E-posti jagamine

Saad märkide autasusid e-posti teel saata kahel viisil:

Avalikult jagamise lehelt

Saajad saavad oma märki sõpradega, mentoritega või võimalike tööandjatega jagada, klõpsates jagamise lehel nupul Send Email. Avaneb aken, kus nad sisestavad ühe või mitu e-posti aadressi, valikulise teema ja isikliku sõnumi:

Iga adressaat saab stiilse HTML-e-kirja saatja isikliku sõnumi ja ühe klõpsuga nupuga avaliku autasu lehe vaatamiseks:

Töölaualt

Väljaandjad saavad iga autasu e-posti teel saata töölaua Awards lehelt:

1. Leia autasu Awards lehel.
2. Klõpsa real nupul Send või ava detailide aken ja klõpsa Resend email.
3. Sisesta saaja e-posti aadress ja saada.

Mõlema voo jaoks kasutatakse sama e-kirja malli.

Open Badge v2.0 JSON lõpp-punktid

Koostalitlusvõime tagamiseks teiste märkide platvormidega pakub badges.ninja standardset Open Badge v2.0 JSON-i nendel avalikel lõpp-punktidel:

Lõpp-punkt	Kirjeldus
/certify-badge/issuer/{guid}	Väljaandja profiili JSON
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (autasu)

Need lõpp-punktid tagastavad JSON-LD-d, mis on kooskõlas Open Badge v2.0 spetsifikatsiooniga. Teised märkide platvormid ja kontrollijad saavad neid andmeid tarbida mandaatide valideerimiseks.

Näide — kontrolli autasu:

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 pildi URL-id

Märkide pildid on kinnitatud IPFS-i (InterPlanetary File System) meie enda lüüsi ipfs.ninja kaudu. See tähendab:

• Pildid on püsivad ja sisupõhiselt adresseeritud — neid ei saa muuta ega vaikselt asendada
• Open Badge JSON-is olevad pildi URL-id näevad välja nagu https://ipfs.ninja/ipfs/{cid}
• Sama sisu-ID lahendub iga avaliku IPFS-i lüüsi kaudu (cloudflare-ipfs.com, ipfs.io jne) — sinu märgid pole seotud ühe pakkujaga

Kuna pilt on Open Badge'i kinnituse osa, ei katkesta märgi kunsti hilisem asendamine varem välja antud autasusid: vana IPFS CID jääb igavesti lahendatavaks, nii et ajaloolised autasud säilitavad oma originaalse pildi isegi siis, kui kujundad märgi uute väljaannete jaoks ümber.