Jakaminen ja vahvistaminen

Jokaisella badges.ninja-myönnöllä on julkinen vahvistussivu, jolle kuka tahansa pääsee ilman kirjautumista. Saajat voivat jakaa merkkejään sosiaalisessa mediassa, sähköpostitse tai kopioimalla suoran linkin.

Saajilla on oma portaali

Jos olet ansainnut merkin badges.ninjan kautta, voit kirjautua sisään (salasanaa ei tarvita) osoitteessa badges.ninja/me nähdäksesi kaikki merkkisi yhdessä paikassa ja koostaaksesi julkisen profiilin osoitteeseen badges.ninja/u/<käyttäjätunnuksesi>. Katso Saajan portaali.

Julkinen myöntösivu

Jokaisella myönnöllä on julkinen URL-osoite:

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

Tällä sivulla näytetään merkin kuva (ladattu IPFS:stä), merkin nimi ja kuvaus, saajan nimi, myöntäjän nimi ja logo, myöntämispäivä ja mahdollinen vanhentumispäivä sekä kriteerit, jotka saaja täytti ansaitakseen merkin. Kuka tahansa, jolla on linkki, voi avata sivun varmistaakseen, että tunnustus on aito.

Jos myöntäjä on asettanut LinkedIn-organisaation tunnuksen, näytölle ilmestyy Lisää LinkedIn-profiiliin -painike, jolla saaja voi tallentaa tunnustuksen suoraan LinkedInin Lisenssit ja sertifikaatit -osioon. Lataa merkki -painike tarjoaa alkuperäisen merkkikuvan (suoraan IPFS:stä), ja Lataa PDF luo tulostettavan A4-todistuksen lennosta.

Julkinen jakosivu

Jakosivu tarjoaa sosiaalisen jakamisen vaihtoehdot:

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

Tältä sivulta saajat voivat jakaa merkkinsä seuraavissa palveluissa:

• LinkedIn — julkaisee LinkedIn-syötteeseen tai lisää tunnustuksen suoraan profiiliin Add to LinkedIn Profile -painikkeella (kun myöntäjä on asettanut LinkedIn-organisaation tunnuksen)
• Twitter / X — julkaisee twiitin merkin linkillä ja mukautetulla jakotekstillä
• Facebook — jakaa Facebook-aikajanalla
• WhatsApp — lähettää viestin merkin linkillä
• Telegram — lähettää viestin merkin linkillä
• Send Email — avaa sivun sisäisen modaalin, joka toimittaa tyylitellyn sähköpostin yhdelle tai useammalle vastaanottajalle (katso Sähköpostijakaminen alla)
• Copy Link — kopioi vahvistus-URL:n leikepöydälle
• Embed snippets — kopioi valmiiksi liitettävät <img>- ja <iframe>-HTML-koodit merkin upottamiseksi verkkosivustolle, intranettiin tai sähköpostin allekirjoitukseen

QR-vahvistus

Erillinen vahvistussivu renderöi skannattavan QR-koodin, joka osoittaa omaan URL-osoitteeseensa — täydellinen tulostettuihin todistuksiin, tapahtumabannereihin tai LinkedIn-kuvakaappauksiin.

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

Kuka tahansa, joka skannaa QR-koodin puhelimen kameralla, päätyy live-vahvistussivulle, jossa hän voi varmistaa, että merkki on isännöity osoitteessa badges.ninja, noudattaa Open Badge v2.0 -spesifikaatiota ja (Pro-suunnitelmassa) on ankkuroitu lohkoketjuun Matchainin kautta. Saajan henkilöllisyys näytetään SHA-256-tiivisteenä, joten sähköpostit eivät koskaan paljastu julkisesti.

PDF-todistus

Jokaisella myönnöllä on Lataa todistus -painike julkisella vahvistussivulla. Sen napsauttaminen luo tulostusvalmiin A4-PDF:n lennossa, joka sisältää merkin kuvan, saajan nimen, myöntäjän, kriteerit, myöntämispäivän, valinnaisen vanhentumispäivän ja QR-koodin, joka linkittää takaisin live-vahvistus-URL:ään.

Sosiaalisen median esikatselut

Kun merkin linkki jaetaan LinkedInissä, X:ssä, Slackissa, Facebookissa, WhatsAppissa tai sähköpostissa, alusta hakee jakoendpointin ja renderöi rikkaan kortin Open Graph -metatiedoista, joita badges.ninja lähettää:

• Merkin kuva esikatselukuvana
• Merkin nimi otsikkona
• Myöntäjän nimi ja saajan nimi kuvauksessa

Tämä varmistaa, että merkit näyttävät ammattimaisilta jaettaessa missä tahansa — saajien ei tarvitse liittää omaa kuvaa tai kirjoittaa tekstiä. Esikatselu luodaan palvelinpuolella osoitteessa /certify-badge/award/{guid}/share-html ja välimuistitetaan CDN:n reunalla, joten esikatselut näkyvät heti jo ensimmäisellä jakokerralla.

Sähköpostijakaminen

Voit lähettää merkkimyöntöjä sähköpostitse kahdella tavalla:

Julkiselta jakosivulta

Saajat voivat jakaa merkkinsä ystävien, mentoreiden tai potentiaalisten työnantajien kanssa napsauttamalla Send Email -painiketta jakosivulla. Avautuu modaali, johon he syöttävät yhden tai useamman sähköpostiosoitteen, valinnaisen aiheen ja henkilökohtaisen viestin:

Jokainen vastaanottaja saa tyylitellyn HTML-sähköpostin saajan henkilökohtaisella viestillä ja yhden napsautuksen painikkeella julkisen myöntösivun katsomiseksi:

Hallintapaneelista

Myöntäjät voivat lähettää minkä tahansa myönnön sähköpostitse hallintapaneelin Myönnöt-sivulta:

1. Etsi myöntö Myönnöt-sivulta.
2. Napsauta rivin Send-painiketta tai avaa lisätietomodaali ja napsauta Resend email.
3. Syötä saajan sähköposti ja lähetä.

Molemmissa kuluissa käytetään samaa sähköpostimallia.

Open Badge v2.0 JSON-endpointit

Yhteentoimivuuden takaamiseksi muiden merkkialustojen kanssa badges.ninja tarjoaa standardin Open Badge v2.0 JSON:n näissä julkisissa endpointeissa:

Endpoint	Kuvaus
/certify-badge/issuer/{guid}	Myöntäjän profiili-JSON
/certify-badge/badge/{guid}	BadgeClass-JSON
/certify-badge/award/{guid}	Assertion-JSON (myöntö)

Nämä endpointit palauttavat JSON-LD:n, joka on yhteensopiva Open Badge v2.0 -spesifikaation kanssa. Muut merkkialustat ja vahvistajat voivat käyttää näitä tietoja tunnustusten validointiin.

Esimerkki — vahvista myöntö:

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-kuvaosoitteet

Merkkien kuvat on kiinnitetty IPFS:ään (InterPlanetary File System) oman yhdyskäytävämme ipfs.ninja kautta. Tämä tarkoittaa:

• Kuvat ovat pysyviä ja sisältöosoitteisia — niitä ei voi peukaloida tai vaihtaa hiljaa
• Kuvien URL-osoitteet Open Badge JSON:ssa näyttävät tältä: https://ipfs.ninja/ipfs/{cid}
• Sama sisältötunniste ratkaistuu minkä tahansa julkisen IPFS-yhdyskäytävän (cloudflare-ipfs.com, ipfs.io jne.) kautta — merkkisi eivät ole sidottuja yhteen palveluntarjoajaan

Koska kuva on osa Open Badge -assertiota, merkin grafiikan korvaaminen myöhemmin ei riko aiemmin myönnettyjä myöntöjä: vanha IPFS-CID pysyy ratkaistavissa ikuisesti, joten historialliset myönnöt säilyttävät alkuperäisen kuvansa, vaikka suunnittelisit merkin uudelleen uusia myöntöjä varten.