Jakaminen ja varmennus

Jokaisella badges.ninja-todistuksella on julkinen varmennussivu, jolle kuka tahansa pääsee kirjautumatta sisään. Vastaanottajat voivat jakaa merkkinsä sosiaalisessa mediassa, sähköpostilla tai kopioimalla suoran linkin.

Vastaanottajilla on myös oma portaali

Jos olet ansainnut merkin badges.ninjan kautta, voit kirjautua sisään (salasanaa ei tarvita) osoitteessa badges.ninja/me, nähdä kaikki merkkisi yhdessä paikassa ja muokata julkista profiilia osoitteessa badges.ninja/u/<your-handle>. Katso Vastaanottajan portaali.

Julkinen todistussivu

Jokaisella todistuksella on julkinen URL-osoite:

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

Sivulla näkyvät merkin kuva, merkin nimi ja kuvaus, vastaanottajan nimi, myöntäjän nimi ja logo, myöntöpäivä ja mahdollinen voimassaolon päättymispäivä sekä kriteerit, jotka vastaanottaja täytti ansaitakseen merkin. Kuka tahansa linkin saanut voi avata sivun ja varmistaa, että todistus on aito.

Todistussivulla on aina Add to LinkedIn profile -painike, jolla vastaanottaja voi tallentaa todistuksen suoraan LinkedInin Licenses & Certifications -osioon. (Jos myöntäjä on asettanut LinkedIn-organisaatiotunnuksen, LinkedIn täyttää varmennetun yrityssivun valmiiksi; muuten käytetään myöntäjän nimeä.) Yksi Lataa-pudotusvalikko tarjoaa kaksi vaihtoehtoa: Merkin kuva (alkuperäinen PNG) ja Todistus (tulostettava A4-PDF, joka luodaan lennossa osoitteessa /certify-badge/award/{guid}/pdf).

Julkinen jakosivu

Jakosivu tarjoaa sosiaalisen jakamisen vaihtoehdot:

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

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

• LinkedIn — julkaisee merkin LinkedIn-syötteessä (jos haluat lisätä todistuksen suoraan profiiliin, käytä sen sijaan todistussivun Add to LinkedIn profile -painiketta)
• Twitter / X — julkaisee twiitin, jossa on merkin linkki ja mukautettu jakoteksti
• Facebook — jakaa Facebook-aikajanalla
• WhatsApp — lähettää viestin, jossa on merkin linkki
• Telegram — lähettää viestin, jossa on merkin linkki
• Lähetä sähköposti — avaa sivun sisäisen ikkunan, joka lähettää tyylitellyn sähköpostin yhdelle tai usealle vastaanottajalle (katso alla Jakaminen sähköpostilla)
• Kopioi linkki — kopioi varmennus-URL:n leikepöydälle
• Upotuskoodit — kopioi valmis <img>- ja <iframe>-HTML, jolla merkin voi lisätä verkkosivulle, intranetiin tai sähköpostin allekirjoitukseen

QR-varmennus

Erillinen varmennussivu näyttää skannattavan QR-koodin, joka osoittaa sivun omaan URL-osoitteeseen — täydellinen tulostetuille todistuksille, tapahtumabannereille tai LinkedIn-kuvakaappauksille.

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

Kun joku skannaa QR-koodin puhelimen kameralla, hän päätyy live-varmennussivulle, jossa hän voi varmistaa, että merkki sijaitsee osoitteessa badges.ninja ja noudattaa Open Badge v2.0 -määritystä. Vastaanottajan henkilöllisyys näytetään SHA-256-tiivisteenä, joten sähköpostiosoitteita ei koskaan paljasteta julkisesti.

PDF-todistus

Jokaisen todistuksen voi ladata tulostusvalmiina A4-PDF-todistuksena. Todistus-vaihtoehto on julkisen todistussivun (/awards/{guid}) Lataa-pudotusvalikossa — ei varmennussivulla, jolla on vain skannattava QR-koodi ja raaka Open Badge JSON. Valinta luo PDF:n lennossa (osoitteessa /certify-badge/award/{guid}/pdf), ja siinä ovat merkin kuva, vastaanottajan nimi, myöntäjä, kriteerit, myöntöpäivä, valinnainen voimassaolon päättyminen sekä QR-koodi, joka johtaa takaisin live-varmennus-URL:ään.

Sosiaalisen median esikatselut

Kun merkin linkki jaetaan LinkedInissä, X:ssä, Slackissa, Facebookissa, WhatsAppissa tai sähköpostilla, alusta hakee jakopäätepisteen ja muodostaa rikkaan kortin badges.ninjan tuottamien Open Graph -metatietojen perusteella:

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

Näin merkit näyttävät ammattimaisilta missä tahansa ne jaetaankin — vastaanottajien 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 ilmestyvät heti jo ensimmäisellä jakokerralla.

Jakaminen sähköpostilla

Todistuksia voi lähettää sähköpostilla kahdella tavalla:

Julkiselta jakosivulta

Vastaanottajat voivat jakaa merkkinsä ystävien, mentorien tai mahdollisten työnantajien kanssa napsauttamalla jakosivulla Lähetä sähköposti. Avautuu ikkuna, johon he syöttävät yhden tai useamman sähköpostiosoitteen, valinnaisen otsikon ja henkilökohtaisen viestin:

Jokainen vastaanottaja saa tyylitellyn HTML-sähköpostin, jossa on lähettäjän henkilökohtainen viesti ja yhden napsautuksen painike julkisen todistussivun avaamiseen:

Hallintapaneelista

Myöntäjät voivat lähettää minkä tahansa todistuksen sähköpostilla hallintapaneelin Todistukset-sivulta:

1. Etsi todistus Todistukset-sivulta.
2. Napsauta rivin Lähetä-painiketta tai avaa tietoikkuna ja napsauta Lähetä sähköposti uudelleen.
3. Syötä vastaanottajan sähköpostiosoite ja lähetä.

Molemmissa tavoissa käytetään samaa sähköpostipohjaa.

Open Badge v2.0 JSON -päätepisteet

Yhteentoimivuuden varmistamiseksi muiden merkkialustojen kanssa badges.ninja tarjoaa standardin Open Badge v2.0 JSONin seuraavissa julkisissa päätepisteissä:

Päätepiste	Kuvaus
/certify-badge/issuer/{guid}	Myöntäjän profiilin JSON
/certify-badge/badge/{guid}	BadgeClass JSON
/certify-badge/award/{guid}	Assertion JSON (todistus)

Nämä päätepisteet palauttavat Open Badge v2.0 -määrityksen mukaista JSON-LD:tä. Muut merkkialustat ja varmentajat voivat käyttää tätä dataa todistusten validointiin.

Esimerkki — todistuksen varmennus:

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

Merkin kuvien URL-osoitteet

Merkkien kuvat tallennetaan Amazon S3:een ja jaetaan maailmanlaajuisen CDN:n kautta sisältöpohjaisella, muuttumattomalla URL-osoitteella, joka johdetaan kuvan tavujen kryptografisesta tiivisteestä (SHA-256). Tämä tarkoittaa, että:

• Kuvat ovat pysyviä ja sisältöpohjaisia — URL johdetaan itse tavuista, joten niitä ei voi väärentää tai huomaamatta korvata
• Kuvien URL-osoitteet Open Badge JSONissa näyttävät tältä: https://badges.ninja/images/{sha256}.png
• Kuvat tarjoillaan CDN:n reunalta, joten ne latautuvat nopeasti kaikkialla maailmassa ja pysyvät saatavilla todistuksen koko eliniän

Koska kuva on osa Open Badge -assertionia, merkin kuvituksen vaihtaminen myöhemmin ei riko aiemmin myönnettyjä todistuksia: alkuperäinen kuva säilyttää oman sisältöpohjaisen URL-osoitteensa, joten aiemmat todistukset säilyttävät alkuperäisen kuvansa, vaikka suunnittelisit merkin uudelleen uusia myöntöjä varten.