Jagamine ja kinnitamine

Igal badges.ninja tunnistusel on avalik kinnitamise leht, millele pääseb ligi igaüks ilma sisse logimata. Saajad saavad oma märke jagada sotsiaalmeedias, e-posti teel või otselinki kopeerides.

Saajatel on ka oma portaal

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

Avalik tunnistuse leht

Igal tunnistusel on avalik URL:

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

See leht kuvab märgi pildi, märgi nime ja kirjelduse, saaja nime, väljaandja nime ja logo, väljaandmise kuupäeva ja võimaliku aegumiskuupäeva ning kriteeriumid, mille saaja märgi teenimiseks täitis. Igaüks, kellel on link, saab lehe avada ja veenduda, et tunnistus on autentne.

Tunnistuse lehel on alati nupp Add to LinkedIn profile, et saaja saaks tunnistuse otse oma LinkedIni jaotisse Licenses & Certifications salvestada. (Kui väljaandja määras LinkedIni organisatsiooni ID, täidab LinkedIn automaatselt kinnitatud ettevõtte lehe; vastasel juhul kasutatakse väljaandja nime.) Üks Laadi alla rippmenüü pakub kahte valikut: Märgi pilt (algne PNG) ja Sertifikaat (prinditav A4 PDF, mis genereeritakse kohapeal aadressil /certify-badge/award/{guid}/pdf).

Avalik jagamise leht

Jagamise leht pakub sotsiaalse jagamise valikuid:

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

Sellelt lehelt saavad saajad oma märki jagada kanalites:

• LinkedIn — postitab märgi nende LinkedIni voogu (tunnistuse otse profiilile lisamiseks kasuta selle asemel tunnistuse lehel olevat nuppu Add to LinkedIn profile)
• Twitter / X — postitab säutsu märgi lingi ja kohandatud jagamisteksti
• Facebook — jagab nende Facebooki ajajoonel
• WhatsApp — saadab sõnumi märgi lingiga
• Telegram — saadab sõnumi märgi lingiga
• Saada e-kiri — avab lehesisese akna, mis edastab kujundatud e-kirja ühele või mitmele saajale (vaata allpool jaotist E-posti teel jagamine)
• Kopeeri link — kopeerib kinnitamise URL-i lõikelauale
• Manustamiskoodid — kopeeri kasutusvalmis <img> ja <iframe> HTML, et lisada märk veebilehele, intranetti või e-kirja allkirja

QR-kinnitamine

Eraldi kinnitamise leht kuvab skannitava QR-koodi, mis viitab selle enda URL-ile — ideaalne prinditud sertifikaatidele, ürituse plakatitele või LinkedIni ekraanipiltidele.

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

Igaüks, kes skannib QR-koodi telefoni kaameraga, jõuab otse kinnitamise lehele, kus ta saab veenduda, et märk asub serveris badges.ninja ja vastab Open Badge v2.0 spetsifikatsioonile. Saaja identiteet kuvatakse SHA-256 räsina, nii et e-posti aadresse ei avaldata kunagi avalikult.

PDF-sertifikaat

Iga tunnistuse saab alla laadida prindivalmis A4 PDF-sertifikaadina. Valik Sertifikaat asub avaliku tunnistuse lehe (/awards/{guid}) rippmenüüs Laadi alla — mitte kinnitamise lehel, kus on ainult skannitav QR-kood ja toores Open Badge JSON. Valiku kasutamisel genereeritakse PDF kohapeal (aadressil /certify-badge/award/{guid}/pdf) märgi pildi, saaja nime, väljaandja, kriteeriumide, väljaandmise kuupäeva, valikulise aegumise ja QR-koodiga, mis viitab tagasi kinnitamise URL-ile.

Sotsiaalmeedia eelvaated

Kui märgi linki jagatakse LinkedInis, X-is, Slackis, Facebookis, WhatsAppis või e-posti teel, pärib platvorm jagamise lõpp-punkti ja kuvab rikkaliku kaardi badges.ninja edastatud Open Graph metaandmete põhjal:

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

See tagab, et märgid näevad professionaalsed välja igal pool, kus neid jagatakse — saajatel ei ole vaja ise pilti lisada ega teksti kirjutada. Eelvaade genereeritakse serveripoolselt aadressil /certify-badge/award/{guid}/share-html ja vahemällu salvestatakse CDN-i servas, nii et eelvaated ilmuvad kohe, isegi esimesel jagamisel.

E-posti teel jagamine

Tunnistusi saab e-posti teel saata kahel viisil:

Avalikult jagamise lehelt

Saajad saavad oma märki sõprade, mentorite või võimalike tööandjatega jagada, klõpsates jagamise lehel nuppu Saada e-kiri. Avaneb aken, kus nad sisestavad ühe või mitu e-posti aadressi, valikulise teema ja isikliku sõnumi:

Iga adressaat saab kujundatud HTML-kirja, milles on saaja isiklik sõnum ja ühe klõpsuga nupp avaliku tunnistuse lehe vaatamiseks:

Töölaualt

Väljaandjad saavad iga tunnistuse e-posti teel saata töölaua lehelt Tunnistused:

1. Leia tunnistus lehelt Tunnistused.
2. Klõpsa real nuppu Saada või ava detailide aken ja klõpsa Saada e-kiri uuesti.
3. Sisesta saaja e-posti aadress ja saada.

Mõlema töövoo puhul kasutatakse sama e-kirja malli.

Open Badge v2.0 JSON-lõpp-punktid

Koostalitlusvõime tagamiseks teiste märgiplatvormidega pakub badges.ninja standardset Open Badge v2.0 JSON-i järgmistes avalikes lõpp-punktides:

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

Need lõpp-punktid tagastavad Open Badge v2.0 spetsifikatsioonile vastavat JSON-LD-d. Teised märgiplatvormid ja kinnitajad saavad neid andmeid tunnistuste kinnitamiseks kasutada.

Näide — tunnistuse kinnitamine:

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"
  }
}

Märgi piltide URL-id

Märgi pildid salvestatakse Amazon S3-s ja edastatakse meie ülemaailmse CDN-i kaudu sisupõhise muutumatu URL-i all, mis tuletatakse pildi baitide krüptograafilisest räsist (SHA-256). See tähendab:

• Pildid on püsivad ja sisupõhised — URL tuletatakse baitidest endist, seega neid ei saa võltsida ega märkamatult asendada
• Piltide URL-id Open Badge JSON-is näevad välja nagu https://badges.ninja/images/{sha256}.png
• Pilte serveeritakse CDN-i servast, seega laadivad need kiiresti kõikjal maailmas ja jäävad kättesaadavaks kogu tunnistuse eluea

Kuna pilt on osa Open Badge assertionist, ei riku märgi kujunduse hilisem asendamine varem väljaantud tunnistusi: algne pilt säilitab oma sisupõhise URL-i, mistõttu ajaloolised tunnistused säilitavad oma algse pildi isegi siis, kui kujundad märgi uute väljaandmiste jaoks ümber.