Berbagi & Verifikasi

Setiap penghargaan di badges.ninja memiliki halaman verifikasi publik yang dapat diakses siapa saja tanpa perlu masuk. Penerima dapat membagikan lencana mereka di media sosial, melalui email, atau dengan menyalin tautan langsung.

Penerima juga memiliki portal sendiri

Jika Anda telah memperoleh lencana melalui badges.ninja, Anda dapat masuk (tanpa perlu kata sandi) di badges.ninja/me untuk melihat semua lencana Anda di satu tempat dan menyusun profil publik di badges.ninja/u/<handle-anda>. Lihat Portal Penerima.

Halaman Penghargaan Publik

Setiap penghargaan memiliki URL publik:

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

Halaman ini menampilkan gambar lencana (dimuat dari IPFS), nama dan deskripsi lencana, nama penerima, nama dan logo penerbit, tanggal penerbitan dan tanggal kedaluwarsa (jika ada), serta kriteria yang dipenuhi penerima untuk memperoleh lencana. Siapa pun yang memiliki tautan dapat membuka halaman tersebut untuk memastikan bahwa kredensial itu autentik.

Jika penerbit telah menetapkan ID organisasi LinkedIn, tombol Add to LinkedIn profile akan muncul sehingga penerima dapat menyimpan kredensial langsung ke bagian Lisensi & Sertifikasi LinkedIn mereka. Tombol Download Badge menyajikan gambar lencana asli (langsung dari IPFS), dan Download PDF menghasilkan sertifikat A4 siap cetak secara langsung.

Halaman Berbagi Publik

Halaman berbagi menyediakan opsi berbagi sosial:

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

Dari halaman ini, penerima dapat membagikan lencana mereka di:

• LinkedIn — memposting ke umpan LinkedIn mereka, atau menambahkan kredensial langsung ke profil melalui tombol Add to LinkedIn Profile (jika penerbit telah menetapkan ID organisasi LinkedIn)
• Twitter / X — memposting tweet dengan tautan lencana dan teks berbagi khusus
• Facebook — membagikan ke linimasa Facebook mereka
• WhatsApp — mengirim pesan dengan tautan lencana
• Telegram — mengirim pesan dengan tautan lencana
• Send Email — membuka modal di halaman yang mengirimkan email bergaya ke satu atau banyak penerima (lihat Berbagi Melalui Email di bawah)
• Copy Link — menyalin URL verifikasi ke papan klip
• Embed snippets — menyalin HTML <img> dan <iframe> siap-tempel untuk menyematkan lencana ke situs web, intranet, atau tanda tangan email

Verifikasi QR

Halaman verifikasi khusus menampilkan kode QR yang dapat dipindai dan mengarah ke URL-nya sendiri — ideal untuk sertifikat cetak, banner acara, atau tangkapan layar LinkedIn.

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

Siapa pun yang memindai QR dengan kamera ponsel akan dibawa ke halaman verifikasi langsung, di mana mereka dapat memastikan bahwa lencana di-host di badges.ninja, mengikuti spesifikasi Open Badge v2.0, dan (pada paket Pro) ditambatkan secara on-chain melalui Matchain. Identitas penerima ditampilkan sebagai hash SHA-256 sehingga email tidak pernah terekspos secara publik.

Sertifikat PDF

Setiap penghargaan memiliki tombol Download Certificate di halaman verifikasi publik. Mengkliknya akan menghasilkan PDF A4 siap cetak secara langsung yang mencakup gambar lencana, nama penerima, penerbit, kriteria, tanggal penerbitan, masa kedaluwarsa opsional, dan kode QR yang menautkan kembali ke URL verifikasi langsung.

Pratinjau Media Sosial

Saat tautan lencana dibagikan di LinkedIn, X, Slack, Facebook, WhatsApp, atau email, platform akan mengambil endpoint berbagi dan merender kartu kaya dari metadata Open Graph yang dipancarkan badges.ninja:

• Gambar lencana sebagai gambar pratinjau
• Nama lencana sebagai judul
• Nama penerbit dan nama penerima dalam deskripsi

Hal ini memastikan lencana terlihat profesional saat dibagikan di mana pun — penerima tidak perlu melampirkan gambar mereka sendiri atau menulis salinan. Pratinjau dihasilkan di sisi server di /certify-badge/award/{guid}/share-html dan di-cache di edge CDN, sehingga pratinjau muncul seketika bahkan pada berbagi pertama.

Berbagi Melalui Email

Anda dapat mengirim penghargaan lencana melalui email dengan dua cara:

Dari Halaman Berbagi Publik

Penerima dapat membagikan lencana mereka kepada teman, mentor, atau calon pemberi kerja dengan mengklik Send Email di halaman berbagi. Sebuah modal akan terbuka di mana mereka memasukkan satu atau beberapa alamat email, subjek opsional, dan pesan pribadi:

Setiap penerima alamat akan menerima email HTML bergaya dengan pesan pribadi penerima dan tombol satu klik untuk melihat halaman penghargaan publik:

Dari Dasbor

Penerbit dapat mengirim penghargaan apa pun melalui email dari halaman Awards di dasbor:

1. Cari penghargaan di halaman Awards.
2. Klik tombol Send pada baris tersebut, atau buka modal detail dan klik Resend email.
3. Masukkan email penerima dan kirim.

Templat email yang sama digunakan untuk kedua alur tersebut.

Endpoint JSON Open Badge v2.0

Untuk interoperabilitas dengan platform lencana lain, badges.ninja menyediakan JSON Open Badge v2.0 standar di endpoint publik berikut:

Endpoint	Deskripsi
/certify-badge/issuer/{guid}	JSON profil penerbit
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (penghargaan)

Endpoint ini mengembalikan JSON-LD yang sesuai dengan spesifikasi Open Badge v2.0. Platform lencana dan verifikator lain dapat mengonsumsi data ini untuk memvalidasi kredensial.

Contoh — verifikasi penghargaan:

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

URL Gambar IPFS

Gambar lencana di-pin ke IPFS (InterPlanetary File System) melalui gateway kami sendiri, ipfs.ninja. Ini berarti:

• Gambar bersifat permanen dan dialamatkan berdasarkan konten — gambar tidak dapat dirusak atau diganti secara diam-diam
• URL gambar di JSON Open Badge tampak seperti https://ipfs.ninja/ipfs/{cid}
• ID-konten yang sama dapat diselesaikan melalui gateway IPFS publik mana pun (cloudflare-ipfs.com, ipfs.io, dll.) — lencana Anda tidak terkunci pada satu penyedia

Karena gambar adalah bagian dari assertion Open Badge, mengganti karya seni lencana di kemudian hari tidak akan merusak penghargaan yang telah diterbitkan sebelumnya: CID IPFS lama tetap dapat diselesaikan selamanya, sehingga penghargaan historis tetap mempertahankan gambar aslinya bahkan jika Anda mendesain ulang lencana untuk penerbitan baru.