Skip to content

Pagbabahagi at Pagberipika

Bawat award sa badges.ninja ay may pampublikong verification page na maaaring i-access ng kahit sino nang hindi nag-sa-sign in. Maaaring ibahagi ng mga tatanggap ang kanilang mga badge sa social media, sa pamamagitan ng email, o sa pamamagitan ng pagkopya ng direktang link.

May sariling portal din ang mga tatanggap

Kung nakakuha ka ng badge sa pamamagitan ng badges.ninja, maaari kang mag-sign in (hindi kailangan ng password) sa badges.ninja/me upang makita ang lahat ng iyong badge sa isang lugar at i-curate ang isang pampublikong profile sa badges.ninja/u/<iyong-handle>. Tingnan ang Recipient Portal.

Pampublikong Award Page

Bawat award ay may pampublikong URL:

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

Ipinapakita ng pahinang ito ang larawan ng badge (na-load mula sa IPFS), ang pangalan at paglalarawan ng badge, ang pangalan ng tatanggap, ang pangalan at logo ng issuer, ang petsa ng pag-isyu at anumang petsa ng pag-expire, at ang mga pamantayang natugunan ng tatanggap upang makamit ang badge. Sinumang may link ay maaaring buksan ang pahina upang kumpirmahin na ang credential ay tunay.

Pampublikong award page

Kung nag-set ang issuer ng LinkedIn organization ID, lalabas ang button na Add to LinkedIn profile upang maaaring i-save ng tatanggap ang credential nang direkta sa kanyang LinkedIn Licenses & Certifications. Ang button na Download Badge ay naghahatid ng orihinal na larawan ng badge (direkta mula sa IPFS), at ang Download PDF ay bumubuo ng nai-print na A4 certificate sa parehong sandali.

Pampublikong Share Page

Ang share page ay nagbibigay ng mga opsyon para sa pagbabahagi sa social:

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

Pampublikong share page na may mga social na button at embed snippets

Mula sa pahinang ito, maaaring ibahagi ng mga tatanggap ang kanilang badge sa:

  • LinkedIn — nagpo-post sa kanilang LinkedIn feed, o nagdadagdag ng credential nang direkta sa kanilang profile sa pamamagitan ng button na Add to LinkedIn Profile (kapag nag-set ang issuer ng LinkedIn organization ID)
  • Twitter / X — nagpo-post ng tweet kasama ang link ng badge at custom na share text
  • Facebook — nagbabahagi sa kanilang Facebook timeline
  • WhatsApp — nagpapadala ng mensahe na may link ng badge
  • Telegram — nagpapadala ng mensahe na may link ng badge
  • Send Email — nagbubukas ng in-page modal na naghahatid ng styled email sa isa o maraming tatanggap (tingnan ang Email Sharing sa ibaba)
  • Copy Link — kinokopya ang verification URL sa clipboard
  • Embed snippets — kinokopya ang ready-to-paste na <img> at <iframe> HTML upang mailagay ang badge sa isang website, intranet, o email signature

QR Verification

Ang isang nakatuong verification page ay nagre-render ng scannable na QR code na tumuturo sa sariling URL nito — perpekto para sa mga naka-print na sertipiko, banner ng kaganapan, o screenshot sa LinkedIn.

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

QR verification page na may pagkakakilanlan ng badge, blockchain proof, at scannable QR code

Sinumang nag-scan ng QR gamit ang camera ng telepono ay mapupunta sa live verification page, kung saan maaari nilang kumpirmahin na ang badge ay naka-host sa badges.ninja, sumusunod sa Open Badge v2.0 spec, at (sa Pro plan) ay naka-anchor on-chain sa pamamagitan ng Matchain. Ang pagkakakilanlan ng tatanggap ay ipinapakita bilang isang SHA-256 hash kaya hindi kailanman pampublikong nailalantad ang mga email.

PDF Certificate

Bawat award ay may button na Download Certificate sa pampublikong verification page. Ang pag-click dito ay bumubuo ng print-ready na A4 PDF sa parehong sandali na may kasamang larawan ng badge, pangalan ng tatanggap, issuer, pamantayan, petsa ng pag-isyu, opsyonal na pag-expire, at QR code na nag-uugnay pabalik sa live verification URL.

Mga Preview sa Social Media

Kapag ibinahagi ang isang badge link sa LinkedIn, X, Slack, Facebook, WhatsApp, o email, kinukuha ng platform ang share endpoint at nire-render ang isang mayamang card mula sa Open Graph metadata na inilalabas ng badges.ninja:

  • Larawan ng badge bilang preview image
  • Pangalan ng badge bilang pamagat
  • Pangalan ng issuer at pangalan ng tatanggap sa paglalarawan

Kung paano nagre-render ang ibinahaging link ng badge bilang preview card sa social media

Tinitiyak nito na ang mga badge ay mukhang propesyonal kapag ibinahagi kahit saan — hindi kailangan ng mga tatanggap na mag-attach ng kanilang sariling larawan o magsulat ng kopya. Ang preview ay nabubuo sa server-side sa /certify-badge/award/{guid}/share-html at na-cache sa CDN edge, kaya lumalabas ang mga preview kaagad kahit sa unang share.

Email Sharing

Maaari mong ipadala ang mga badge award sa pamamagitan ng email sa dalawang paraan:

Mula sa Pampublikong Share Page

Maaaring ibahagi ng mga tatanggap ang kanilang badge sa mga kaibigan, mentor, o potensyal na employer sa pamamagitan ng pag-click sa Send Email sa share page. Magbubukas ang isang modal kung saan inilalagay nila ang isa o higit pang email address, opsyonal na subject, at personal na mensahe:

In-page send email modal — naglalagay ang mga tatanggap ng mga address, subject, at personal na mensahe

Bawat addressee ay tumatanggap ng styled HTML email na may personal na mensahe ng tatanggap at one-click button upang tingnan ang pampublikong award page:

Ang aktwal na email na natatanggap ng bawat addressee

Mula sa Dashboard

Maaaring magpadala ang mga issuer ng anumang award sa pamamagitan ng email mula sa Awards page sa dashboard:

  1. Hanapin ang award sa Awards page.
  2. I-click ang button na Send sa row, o buksan ang detail modal at i-click ang Resend email.
  3. Ilagay ang email ng tatanggap at ipadala.

Ang parehong template ng email ay ginagamit para sa parehong daloy.

Mga Endpoint ng JSON ng Open Badge v2.0

Para sa interoperability sa iba pang badge platform, nagbibigay ang badges.ninja ng standard na Open Badge v2.0 JSON sa mga sumusunod na pampublikong endpoint:

EndpointPaglalarawan
/certify-badge/issuer/{guid}Issuer profile JSON
/certify-badge/badge/{guid}BadgeClass JSON
/certify-badge/award/{guid}Assertion JSON (ang award)

Ang mga endpoint na ito ay nagbabalik ng JSON-LD na sumusunod sa Open Badge v2.0 specification. Ang ibang mga badge platform at verifier ay maaaring gumamit ng data na ito upang ma-validate ang mga credential.

Halimbawa — i-verify ang isang award:

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

Mga URL ng Larawan sa IPFS

Ang mga larawan ng badge ay naka-pin sa IPFS (the InterPlanetary File System) sa pamamagitan ng aming sariling gateway, ipfs.ninja. Ibig sabihin nito:

  • Ang mga larawan ay permanente at content-addressed — hindi sila maaaring baguhin o tahimik na palitan
  • Ang mga URL ng larawan sa Open Badge JSON ay mukhang https://ipfs.ninja/ipfs/{cid}
  • Ang parehong content-ID ay maaaring i-resolve sa pamamagitan ng anumang pampublikong IPFS gateway (cloudflare-ipfs.com, ipfs.io, atbp.) — ang iyong mga badge ay hindi naka-lock sa isang provider

Dahil ang larawan ay bahagi ng Open Badge assertion, ang pagpapalit ng artwork ng badge sa kalaunan ay hindi sumisira sa mga dating naibigay na award: ang lumang IPFS CID ay nananatiling resolvable magpakailanman, kaya pinananatili ng mga pang-historikong award ang kanilang orihinal na larawan kahit na muling i-design mo ang badge para sa mga bagong pag-isyu.

badges.ninja Documentation