Skip to content

Kopīgošana un verifikācija

Katrai badges.ninja izsniegtajai nozīmītei ir publiska verifikācijas lapa, kurai jebkurš var piekļūt, neveicot pierakstīšanos. Saņēmēji var kopīgot savas nozīmītes sociālajos tīklos, pa e-pastu vai kopējot tiešo saiti.

Saņēmējiem ir arī sava portāla vide

Ja esi nopelnījis nozīmīti, izmantojot badges.ninja, vari pierakstīties (paroles nav nepieciešamas) vietnē badges.ninja/me, lai redzētu visas savas nozīmītes vienuviet un izveidotu publisku profilu adresē badges.ninja/u/<tava-saite>. Skati Saņēmēja portāls.

Publiskā nozīmītes lapa

Katrai izsniegtai nozīmītei ir publisks URL:

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

Šajā lapā tiek parādīts nozīmītes attēls (ielādēts no IPFS), nozīmītes nosaukums un apraksts, saņēmēja vārds, izdevēja nosaukums un logotips, izdošanas datums un iespējamais derīguma termiņš, kā arī kritēriji, kurus saņēmējs izpildījis, lai iegūtu nozīmīti. Jebkurš, kuram ir saite, var atvērt lapu, lai pārliecinātos, ka apliecinājums ir autentisks.

Publiskā nozīmītes lapa

Ja izdevējs ir norādījis LinkedIn organizācijas ID, parādās poga Add to LinkedIn profile, lai saņēmējs varētu saglabāt apliecinājumu tieši savā LinkedIn sadaļā Licences un sertifikāti. Poga Download Badge lejupielādē oriģinālo nozīmītes attēlu (tieši no IPFS), bet Download PDF uzreiz ģenerē izdrukājamu A4 formāta sertifikātu.

Publiskā kopīgošanas lapa

Kopīgošanas lapa piedāvā sociālo kopīgošanas iespēju izvēli:

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

Publiskā kopīgošanas lapa ar sociālo tīklu pogām un iegulšanas fragmentiem

No šīs lapas saņēmēji var kopīgot savu nozīmīti šādās platformās:

  • LinkedIn — publicē ierakstu LinkedIn plūsmā vai pievieno apliecinājumu tieši profilam, izmantojot pogu Add to LinkedIn Profile (ja izdevējs ir iestatījis LinkedIn organizācijas ID)
  • Twitter / X — publicē tvītu ar nozīmītes saiti un pielāgotu kopīgošanas tekstu
  • Facebook — kopīgo Facebook laika joslā
  • WhatsApp — nosūta ziņu ar nozīmītes saiti
  • Telegram — nosūta ziņu ar nozīmītes saiti
  • Send Email — atver lapā integrētu logu, kas nosūta noformētu e-pastu vienam vai vairākiem adresātiem (skati E-pasta kopīgošana zemāk)
  • Copy Link — kopē verifikācijas URL starpliktuvē
  • Embed snippets — kopē gatavus <img> un <iframe> HTML fragmentus, lai nozīmīti iegultu vietnē, iekštīklā vai e-pasta parakstā

QR verifikācija

Atsevišķa verifikācijas lapa ģenerē skenējamu QR kodu, kas norāda uz pašu lapas URL — ideāli piemērots drukātiem sertifikātiem, pasākumu baneriem vai LinkedIn ekrānuzņēmumiem.

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

QR verifikācijas lapa ar nozīmītes identitāti, blokķēdes apliecinājumu un skenējamu QR kodu

Jebkurš, kas noskenē QR kodu ar tālruņa kameru, nokļūst dzīvajā verifikācijas lapā, kur var pārliecināties, ka nozīmīte tiek mitināta vietnē badges.ninja, atbilst Open Badge v2.0 specifikācijai un (Pro plānā) ir noenkurota blokķēdē, izmantojot Matchain. Saņēmēja identitāte tiek parādīta kā SHA-256 jaucējkods, lai e-pasta adreses nekad nebūtu publiski redzamas.

PDF sertifikāts

Katrai izsniegtai nozīmītei publiskajā verifikācijas lapā ir poga Download Certificate. Noklikšķinot uz tās, uzreiz tiek ģenerēts drukāšanai gatavs A4 PDF, kas ietver nozīmītes attēlu, saņēmēja vārdu, izdevēju, kritērijus, izdošanas datumu, iespējamo derīguma termiņu un QR kodu, kas ved atpakaļ uz dzīvo verifikācijas URL.

Sociālo tīklu priekšskatījumi

Kad nozīmītes saite tiek kopīgota LinkedIn, X, Slack, Facebook, WhatsApp vai e-pastā, platforma izgūst kopīgošanas galapunktu un attēlo bagātīgu kartīti no Open Graph metadatiem, ko nodrošina badges.ninja:

  • Nozīmītes attēls kā priekšskatījuma attēls
  • Nozīmītes nosaukums kā virsraksts
  • Izdevēja un saņēmēja vārdi aprakstā

Kā kopīgota nozīmītes saite tiek attēlota kā sociālo tīklu priekšskatījuma kartīte

Tas nodrošina, ka nozīmītes izskatās profesionāli, kur vien tās tiktu kopīgotas — saņēmējiem nav jāpievieno savs attēls vai jāraksta apraksts. Priekšskatījums tiek ģenerēts servera pusē adresē /certify-badge/award/{guid}/share-html un tiek kešots CDN tīkla malā, tāpēc priekšskatījumi parādās uzreiz pat pirmajā kopīgošanas reizē.

E-pasta kopīgošana

Nozīmītes pa e-pastu var nosūtīt divos veidos:

No publiskās kopīgošanas lapas

Saņēmēji var kopīgot savu nozīmīti ar draugiem, mentoriem vai potenciālajiem darba devējiem, noklikšķinot uz Send Email kopīgošanas lapā. Atveras logs, kurā tiek ievadītas viena vai vairākas e-pasta adreses, neobligāts temats un personisks ziņojums:

Lapā integrēts e-pasta sūtīšanas logs — saņēmēji ievada adreses, tematu un personisku piezīmi

Katrs adresāts saņem noformētu HTML e-pastu ar saņēmēja personisko ziņojumu un viena klikšķa pogu, lai apskatītu publisko nozīmītes lapu:

Faktiskais e-pasts, ko saņem katrs adresāts

No paneļa

Izdevēji jebkuru izsniegto nozīmīti var nosūtīt pa e-pastu no Awards lapas vadības panelī:

  1. Atrodi izsniegto nozīmīti Awards lapā.
  2. Noklikšķini uz pogas Send rindā vai atver detalizēto logu un noklikšķini uz Resend email.
  3. Ievadi saņēmēja e-pasta adresi un nosūti.

Abos gadījumos tiek izmantota viena un tā pati e-pasta veidne.

Open Badge v2.0 JSON galapunkti

Lai nodrošinātu sadarbspēju ar citām nozīmīšu platformām, badges.ninja piedāvā standarta Open Badge v2.0 JSON šajos publiskajos galapunktos:

GalapunktsApraksts
/certify-badge/issuer/{guid}Izdevēja profila JSON
/certify-badge/badge/{guid}BadgeClass JSON
/certify-badge/award/{guid}Assertion JSON (izsniegtā nozīmīte)

Šie galapunkti atgriež JSON-LD, kas atbilst Open Badge v2.0 specifikācijai. Citas nozīmīšu platformas un verifikatori var izmantot šos datus, lai apliecinātu apliecinājumu derīgumu.

Piemērs — verificēt izsniegto nozīmīti:

bash
curl https://api.badges.ninja/certify-badge/award/abc123-def456
json
{
  "@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 attēlu URL

Nozīmīšu attēli tiek piesprausti pie IPFS (InterPlanetary File System) caur mūsu pašu vārteju ipfs.ninja. Tas nozīmē:

  • Attēli ir pastāvīgi un satura-adresēti — tos nevar viltot vai klusi nomainīt
  • Attēlu URL Open Badge JSON izskatās šādi: https://ipfs.ninja/ipfs/{cid}
  • Tas pats satura ID tiek atrisināts caur jebkuru publisku IPFS vārteju (cloudflare-ipfs.com, ipfs.io u.c.) — tavas nozīmītes nav piesietas vienam pakalpojuma sniedzējam

Tā kā attēls ir daļa no Open Badge apliecinājuma, vēlāka nozīmītes mākslinieciskā noformējuma nomaiņa nesabojā iepriekš izsniegtās nozīmītes: vecais IPFS CID paliek atrisināms uz mūžu, tāpēc vēsturiski izsniegtās nozīmītes saglabā savu oriģinālo attēlu, pat ja jaunajiem izsniegumiem nozīmīti pārveido.

badges.ninja Documentation