Berbagi & Verifikasi

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

Penerima juga punya portal sendiri

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

Halaman Kredensial Publik

Setiap kredensial memiliki URL publik:

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

Halaman ini menampilkan gambar lencana, nama dan deskripsi lencana, nama penerima, nama dan logo penerbit, tanggal penerbitan beserta tanggal kedaluwarsa (jika ada), dan kriteria yang dipenuhi penerima untuk memperoleh lencana. Siapa pun yang memiliki tautan dapat membuka halaman ini untuk memastikan keaslian kredensial.

Halaman kredensial selalu menampilkan tombol Add to LinkedIn profile agar penerima dapat langsung menyimpan kredensial ke bagian Licenses & Certifications di LinkedIn mereka. (Jika penerbit mengatur ID organisasi LinkedIn, LinkedIn akan mengisi otomatis Halaman Perusahaan yang terverifikasi; jika tidak, nama penerbit yang digunakan.) Satu menu tarik-turun Download menawarkan dua pilihan: Badge image (PNG asli) dan Certificate (PDF A4 siap cetak yang dibuat secara langsung di /certify-badge/award/{guid}/pdf).

Halaman Berbagi Publik

Halaman berbagi menyediakan opsi berbagi ke media sosial:

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

Dari halaman ini, penerima dapat membagikan lencana mereka melalui:

• LinkedIn — memposting lencana ke beranda LinkedIn mereka (untuk menambahkan kredensial langsung ke profil, gunakan tombol Add to LinkedIn profile di halaman kredensial)
• Twitter / X — memposting tweet berisi tautan lencana dan teks berbagi khusus
• Facebook — membagikan di linimasa Facebook mereka
• WhatsApp — mengirim pesan berisi tautan lencana
• Telegram — mengirim pesan berisi tautan lencana
• Send Email — membuka jendela modal di halaman yang mengirimkan surel berformat ke satu atau banyak penerima (lihat Berbagi Melalui Surel di bawah)
• Copy Link — menyalin URL verifikasi ke papan klip
• Embed snippets — salin HTML <img> dan <iframe> siap tempel untuk menaruh lencana di situs web, intranet, atau tanda tangan surel

Verifikasi QR

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

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

Siapa pun yang memindai QR dengan kamera ponsel akan diarahkan ke halaman verifikasi langsung, tempat mereka dapat memastikan lencana di-host di badges.ninja dan mengikuti spesifikasi Open Badge v2.0. Identitas penerima ditampilkan sebagai hash SHA-256 sehingga alamat surel tidak pernah terekspos secara publik.

Sertifikat PDF

Setiap kredensial dapat diunduh sebagai sertifikat PDF A4 siap cetak. Opsi Certificate terdapat di menu tarik-turun Download pada halaman kredensial publik (/awards/{guid}) — bukan di halaman verifikasi, yang hanya memuat kode QR yang dapat dipindai dan JSON Open Badge mentah. Memilihnya akan membuat PDF secara langsung (di /certify-badge/award/{guid}/pdf) dengan gambar lencana, nama penerima, penerbit, kriteria, tanggal penerbitan, tanggal kedaluwarsa opsional, dan kode QR yang mengarah kembali ke URL verifikasi langsung.

Pratinjau Media Sosial

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

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

Dengan demikian lencana tampil profesional di mana pun dibagikan — penerima tidak perlu melampirkan gambar sendiri atau menulis teks. Pratinjau dibuat di sisi server di /certify-badge/award/{guid}/share-html dan di-cache di tepi CDN, sehingga pratinjau langsung muncul bahkan pada saat pertama kali dibagikan.

Berbagi Melalui Surel

Anda dapat mengirim kredensial melalui surel dengan dua cara:

Dari Halaman Berbagi Publik

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

Setiap alamat tujuan menerima surel HTML berformat berisi pesan pribadi penerima dan tombol sekali klik untuk melihat halaman kredensial publik:

Dari Dasbor

Penerbit dapat mengirim kredensial apa pun melalui surel dari halaman Credentials di dasbor:

1. Temukan kredensial di halaman Credentials.
2. Klik tombol Send pada barisnya, atau buka modal detail lalu klik Resend email.
3. Masukkan surel penerima dan kirim.

Templat surel yang sama digunakan untuk kedua alur.

Endpoint JSON Open Badge v2.0

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

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

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

Contoh — verifikasi sebuah kredensial:

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 Lencana

Gambar lencana disimpan di Amazon S3 dan disajikan melalui CDN global kami dengan URL permanen yang beralamat konten (content-addressed) yang diturunkan dari hash kriptografis (SHA-256) atas byte gambar. Artinya:

• Gambar bersifat permanen dan beralamat konten — URL diturunkan dari byte gambar itu sendiri, sehingga tidak dapat dimanipulasi atau diganti secara diam-diam
• URL gambar dalam JSON Open Badge berbentuk https://badges.ninja/images/{sha256}.png
• Gambar disajikan dari tepi CDN, sehingga dimuat cepat di mana pun di dunia dan tetap tersedia selama masa berlaku kredensial

Karena gambar merupakan bagian dari assertion Open Badge, mengganti karya seni lencana di kemudian hari tidak merusak kredensial yang sudah diterbitkan: gambar asli tetap memiliki URL beralamat kontennya sendiri, sehingga kredensial lama tetap menampilkan gambar aslinya meskipun Anda mendesain ulang lencana untuk penerbitan baru.