Skip to content

Kopīgošana un verifikācija ​

Katram akreditācijas datu ierakstam badges.ninja platformā ir publiska verifikācijas lapa, kurai var piekļūt ikviens bez pieteikšanās. Saņēmēji var kopīgot savas digitālās nozīmes sociālajos tīklos, pa e-pastu vai nokopējot tiešo saiti.

Saņēmējiem ir arī sava platforma

Ja esat ieguvis nozīmi, izmantojot badges.ninja, varat pieteikties (parole nav nepieciešama) vietnē badges.ninja/me, lai redzētu visas savas nozīmes vienuviet un izveidotu publisku profilu vietnē badges.ninja/u/<your-handle>. Skatiet Saņēmēja portāls.

Publiskā akreditācijas datu lapa ​

Katram akreditācijas datu ierakstam ir publisks URL:

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

Šajā lapā tiek rādīts nozīmes attēls, nozīmes nosaukums un apraksts, saņēmēja vārds, izdevēja nosaukums un logotips, izdošanas datums un derīguma termiņš (ja tāds ir), kā arī kritēriji, ko saņēmējs izpildīja, lai iegūtu nozīmi. Ikviens, kam ir saite, var atvērt lapu un pārliecināties, ka akreditācijas dati ir autentiski.

Publiskā akreditācijas datu lapa

Akreditācijas datu lapā vienmēr ir poga Add to LinkedIn profile, lai saņēmējs varētu saglabāt akreditācijas datus tieši savā LinkedIn sadaļā „Licenses & Certifications“. (Ja izdevējs ir norādījis LinkedIn organizācijas ID, LinkedIn iepriekš aizpilda verificēto uzņēmuma lapu; pretējā gadījumā tiek izmantots izdevēja nosaukums.) Viena nolaižamā izvēlne Lejupielādēt piedāvā divas iespējas: Nozīmes attēls (oriģinālais PNG) un Sertifikāts (drukājams A4 PDF, kas tiek ģenerēts uz vietas adresē /certify-badge/award/{guid}/pdf).

Publiskā kopīgošanas lapa ​

Kopīgošanas lapa piedāvā sociālās kopīgošanas iespējas:

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

Publiskā kopīgošanas lapa ar sociālajām pogām un iegulšanas fragmentiem

No šīs lapas saņēmēji var kopīgot savu nozīmi šeit:

  • LinkedIn — publicē nozīmi viņu LinkedIn plūsmā (lai akreditācijas datus pievienotu tieši profilam, izmantojiet pogu Add to LinkedIn profile akreditācijas datu lapā)
  • Twitter / X — publicē tvītu ar nozīmes saiti un pielāgotu kopīgošanas tekstu
  • Facebook — kopīgo viņu Facebook laika joslā
  • WhatsApp — nosūta ziņojumu ar nozīmes saiti
  • Telegram — nosūta ziņojumu ar nozīmes saiti
  • Sūtīt e-pastu — atver lapā iebūvētu modālo logu, kas nosūta stilizētu e-pastu vienam vai vairākiem adresātiem (skatiet Kopīgošana e-pastā tālāk)
  • Kopēt saiti — nokopē verifikācijas URL starpliktuvē
  • Iegulšanas fragmenti — nokopējiet gatavu ielīmēšanai <img> un <iframe> HTML, lai nozīmi ievietotu tīmekļa vietnē, iekštīklā vai e-pasta parakstā

QR verifikācija ​

Īpaša verifikācijas lapa attēlo skenējamu QR kodu, kas norāda uz tās pašas URL — lieliski 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īmes informāciju un skenējamu QR kodu

Ikviens, kas noskenē QR kodu ar tālruņa kameru, nonāk tiešsaistes verifikācijas lapā, kur var pārliecināties, ka nozīme tiek mitināta badges.ninja un atbilst Open Badge v2.0 specifikācijai. Saņēmēja identitāte tiek rādīta kā SHA-256 jaucējkods, tāpēc e-pasta adreses nekad netiek atklātas publiski.

PDF sertifikāts ​

Katru akreditācijas datu ierakstu var lejupielādēt kā drukai gatavu A4 PDF sertifikātu. Opcija Sertifikāts atrodas nolaižamajā izvēlnē Lejupielādēt publiskajā akreditācijas datu lapā (/awards/{guid}) — nevis verifikācijas lapā, kurā ir tikai skenējamais QR kods un neapstrādāts Open Badge JSON. To izvēloties, PDF tiek ģenerēts uz vietas (adresē /certify-badge/award/{guid}/pdf) ar nozīmes attēlu, saņēmēja vārdu, izdevēju, kritērijiem, izdošanas datumu, neobligātu derīguma termiņu un QR kodu, kas ved atpakaļ uz tiešsaistes verifikācijas URL.

Priekšskatījumi sociālajos tīklos ​

Kad nozīmes saite tiek kopīgota LinkedIn, X, Slack, Facebook, WhatsApp vai e-pastā, platforma ielādē kopīgošanas galapunktu un izveido bagātīgu kartīti no Open Graph metadatiem, ko izdod badges.ninja:

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

Kā kopīgota nozīmes saite izskatās sociālā tīkla priekšskatījuma kartītē

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

Kopīgošana e-pastā ​

Akreditācijas datus var nosūtīt pa e-pastu divos veidos:

No publiskās kopīgošanas lapas ​

Saņēmēji var kopīgot savu nozīmi ar draugiem, mentoriem vai potenciālajiem darba devējiem, kopīgošanas lapā noklikšķinot uz Sūtīt e-pastu. Tiek atvērts modālais logs, kurā var ievadīt vienu vai vairākas e-pasta adreses, neobligātu tēmu un personīgu ziņojumu:

Lapā iebūvētais e-pasta sūtīšanas logs — saņēmēji ievada adreses, tēmu un personīgu piezīmi

Katrs adresāts saņem stilizētu HTML e-pastu ar saņēmēja personīgo ziņojumu un vienas pogas klikšķi, lai atvērtu publisko akreditācijas datu lapu:

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

No informācijas paneļa ​

Izdevēji var nosūtīt jebkuru akreditācijas datu ierakstu pa e-pastu no informācijas paneļa lapas „Credentials“:

  1. Atrodiet akreditācijas datu ierakstu lapā „Credentials“.
  2. Noklikšķiniet uz rindas pogas Sūtīt vai atveriet detalizētās informācijas logu un noklikšķiniet uz Atkārtoti nosūtīt e-pastu.
  3. Ievadiet saņēmēja e-pasta adresi un nosūtiet.

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īmju platformām, badges.ninja sniedz 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 (akreditācijas dati)

Šie galapunkti atgriež JSON-LD, kas atbilst Open Badge v2.0 specifikācijai. Citas nozīmju platformas un verifikatori var izmantot šos datus akreditācijas datu validēšanai.

Piemērs — akreditācijas datu verifikācija:

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

Nozīmes attēlu URL ​

Nozīmju attēli tiek glabāti Amazon S3 un piegādāti, izmantojot mūsu globālo CDN, ar pēc satura adresētu nemainīgu URL, kas iegūts no attēla baitu kriptogrāfiskā jaucējkoda (SHA-256). Tas nozīmē:

  • Attēli ir pastāvīgi un adresēti pēc satura — URL tiek atvasināts no pašiem baitiem, tāpēc tos nevar viltot vai klusi aizstāt
  • Attēlu URL Open Badge JSON izskatās šādi: https://badges.ninja/images/{sha256}.png
  • Attēli tiek piegādāti no CDN malas, tāpēc tie ātri ielādējas jebkurā pasaules vietā un paliek pieejami visu akreditācijas datu darbības laiku

Tā kā attēls ir daļa no Open Badge assertion, nozīmes grafikas vēlāka nomaiņa nesabojā iepriekš izdotos akreditācijas datus: oriģinālais attēls saglabā savu pēc satura adresēto URL, tāpēc iepriekšējie akreditācijas dati saglabā oriģinālo attēlu pat tad, ja jūs pārveidojat nozīmes dizainu jauniem izdevumiem.

badges.ninja Documentation