Perkongsian & Pengesahan

Setiap kredensial di badges.ninja mempunyai halaman pengesahan awam yang boleh diakses sesiapa sahaja tanpa log masuk. Penerima boleh berkongsi lencana mereka di media sosial, melalui e-mel, atau dengan menyalin pautan terus.

Penerima juga mempunyai portal sendiri

Jika anda memperoleh lencana melalui badges.ninja, anda boleh log masuk (tanpa kata laluan) di badges.ninja/me untuk melihat semua lencana anda di satu tempat dan menyusun profil awam di badges.ninja/u/<your-handle>. Lihat Portal Penerima.

Halaman Kredensial Awam

Setiap kredensial mempunyai URL awam:

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

Halaman ini memaparkan imej lencana, nama dan perihalan lencana, nama penerima, nama dan logo pengeluar, tarikh pengeluaran serta tarikh luput (jika ada), dan kriteria yang dipenuhi penerima untuk memperoleh lencana. Sesiapa yang mempunyai pautan boleh membuka halaman ini untuk mengesahkan bahawa kredensial tersebut tulen.

Halaman kredensial sentiasa memaparkan butang Tambah ke profil LinkedIn supaya penerima boleh menyimpan kredensial terus ke bahagian Licenses & Certifications LinkedIn mereka. (Jika pengeluar menetapkan ID organisasi LinkedIn, LinkedIn mengisi terlebih dahulu Halaman Syarikat yang telah disahkan; jika tidak, nama pengeluar digunakan.) Satu menu juntai bawah Muat turun menawarkan dua pilihan: Imej lencana (PNG asal) dan Sijil (PDF A4 yang boleh dicetak, dijana serta-merta di /certify-badge/award/{guid}/pdf).

Halaman Kongsi Awam

Halaman kongsi menyediakan pilihan perkongsian sosial:

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

Dari halaman ini, penerima boleh berkongsi lencana mereka di:

• LinkedIn — menyiarkan lencana ke suapan LinkedIn mereka (untuk menambah kredensial terus ke profil, gunakan butang Tambah ke profil LinkedIn pada halaman kredensial)
• Twitter / X — menyiarkan tweet dengan pautan lencana dan teks kongsi tersuai
• Facebook — berkongsi di garis masa Facebook mereka
• WhatsApp — menghantar mesej dengan pautan lencana
• Telegram — menghantar mesej dengan pautan lencana
• Hantar E-mel — membuka modal dalam halaman yang menghantar e-mel bergaya kepada seorang atau ramai penerima (lihat Perkongsian E-mel di bawah)
• Salin Pautan — menyalin URL pengesahan ke papan keratan
• Coretan benam — salin HTML <img> dan <iframe> yang sedia ditampal untuk meletakkan lencana di laman web, intranet, atau tandatangan e-mel

Pengesahan QR

Halaman pengesahan khusus memaparkan kod QR boleh imbas yang menuju ke URL-nya sendiri — sesuai untuk sijil bercetak, sepanduk acara, atau tangkapan skrin LinkedIn.

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

Sesiapa yang mengimbas QR dengan kamera telefon akan sampai ke halaman pengesahan langsung, di mana mereka boleh mengesahkan bahawa lencana dihoskan di badges.ninja dan mematuhi spesifikasi Open Badge v2.0. Identiti penerima dipaparkan sebagai hash SHA-256 supaya e-mel tidak pernah didedahkan secara awam.

Sijil PDF

Setiap kredensial boleh dimuat turun sebagai sijil PDF A4 siap cetak. Pilihan Sijil terdapat dalam menu juntai bawah Muat turun pada halaman kredensial awam (/awards/{guid}) — bukan pada halaman pengesahan, yang hanya membawa kod QR boleh imbas dan JSON Open Badge mentah. Memilihnya menjana PDF serta-merta (di /certify-badge/award/{guid}/pdf) dengan imej lencana, nama penerima, pengeluar, kriteria, tarikh pengeluaran, tarikh luput pilihan, dan kod QR yang memaut kembali ke URL pengesahan langsung.

Pratonton Media Sosial

Apabila pautan lencana dikongsi di LinkedIn, X, Slack, Facebook, WhatsApp, atau e-mel, platform akan mengambil titik akhir kongsi dan memaparkan kad kaya daripada metadata Open Graph yang dihasilkan oleh badges.ninja:

• Imej lencana sebagai imej pratonton
• Nama lencana sebagai tajuk
• Nama pengeluar dan nama penerima dalam perihalan

Ini memastikan lencana kelihatan profesional apabila dikongsi di mana-mana — penerima tidak perlu melampirkan imej sendiri atau menulis teks. Pratonton dijana di bahagian pelayan di /certify-badge/award/{guid}/share-html dan dicache di tepi CDN, jadi pratonton muncul serta-merta walaupun pada perkongsian pertama.

Perkongsian E-mel

Anda boleh menghantar kredensial melalui e-mel dengan dua cara:

Daripada Halaman Kongsi Awam

Penerima boleh berkongsi lencana mereka dengan rakan, mentor, atau bakal majikan dengan mengklik Hantar E-mel pada halaman kongsi. Satu modal dibuka di mana mereka memasukkan satu atau lebih alamat e-mel, subjek pilihan, dan mesej peribadi:

Setiap penerima e-mel menerima e-mel HTML bergaya yang mengandungi mesej peribadi penerima kredensial dan butang satu klik untuk melihat halaman kredensial awam:

Daripada Papan Pemuka

Pengeluar boleh menghantar mana-mana kredensial melalui e-mel dari halaman Kredensial dalam papan pemuka:

1. Cari kredensial pada halaman Kredensial.
2. Klik butang Hantar pada baris tersebut, atau buka modal butiran dan klik Hantar semula e-mel.
3. Masukkan e-mel penerima dan hantar.

Templat e-mel yang sama digunakan untuk kedua-dua aliran.

Titik Akhir JSON Open Badge v2.0

Untuk saling kendali dengan platform lencana lain, badges.ninja menyediakan JSON Open Badge v2.0 standard pada titik akhir awam berikut:

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

Titik akhir ini mengembalikan JSON-LD yang mematuhi spesifikasi Open Badge v2.0. Platform lencana dan pengesah lain boleh menggunakan data ini untuk mengesahkan kredensial.

Contoh — mengesahkan 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 Imej Lencana

Imej lencana disimpan di Amazon S3 dan disalurkan melalui CDN global kami di bawah URL tidak berubah yang beralamat kandungan yang diperoleh daripada hash kriptografi (SHA-256) bagi bait imej. Ini bermakna:

• Imej bersifat kekal dan beralamat kandungan — URL diperoleh daripada bait itu sendiri, jadi ia tidak boleh dipalsukan atau diganti secara senyap
• URL imej dalam JSON Open Badge kelihatan seperti https://badges.ninja/images/{sha256}.png
• Imej disalurkan dari tepi CDN, jadi ia dimuatkan dengan pantas di mana-mana sahaja di dunia dan kekal tersedia sepanjang hayat kredensial

Memandangkan imej merupakan sebahagian daripada assertion Open Badge, menggantikan karya seni lencana kemudian tidak merosakkan kredensial yang telah dikeluarkan: imej asal mengekalkan URL beralamat kandungannya sendiri, jadi kredensial lama mengekalkan imej asalnya walaupun anda mereka bentuk semula lencana untuk pengeluaran baharu.