Perkongsian & Pengesahan

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

Penerima juga mempunyai portal mereka sendiri

Jika anda telah 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 menguruskan profil awam di badges.ninja/u/<pengendali-anda>. Lihat Portal Penerima.

Halaman Anugerah Awam

Setiap anugerah mempunyai URL awam:

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

Halaman ini memaparkan imej lencana (dimuatkan daripada IPFS), nama dan penerangan lencana, nama penerima, nama dan logo pengeluar, tarikh dikeluarkan dan sebarang tarikh tamat tempoh, serta kriteria yang dipenuhi oleh penerima untuk memperoleh lencana tersebut. Sesiapa sahaja yang mempunyai pautan boleh membuka halaman ini untuk mengesahkan kelayakan tersebut sah.

Jika pengeluar telah menetapkan ID organisasi LinkedIn, butang Add to LinkedIn profile akan muncul supaya penerima boleh menyimpan kelayakan terus ke dalam bahagian Lesen & Pensijilan LinkedIn mereka. Butang Download Badge menyediakan imej lencana asal (terus daripada IPFS), dan Download PDF menjana sijil A4 yang boleh dicetak secara serta-merta.

Halaman Perkongsian Awam

Halaman perkongsian menyediakan pilihan untuk berkongsi di media sosial:

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

Daripada halaman ini, penerima boleh berkongsi lencana mereka di:

• LinkedIn — menghantar siaran ke suapan LinkedIn mereka, atau menambah kelayakan terus ke profil mereka melalui butang Add to LinkedIn Profile (apabila pengeluar telah menetapkan ID organisasi LinkedIn)
• Twitter / X — menghantar tweet dengan pautan lencana dan teks perkongsian tersuai
• Facebook — berkongsi di garis masa Facebook mereka
• WhatsApp — menghantar mesej dengan pautan lencana
• Telegram — menghantar mesej dengan pautan lencana
• Send Email — membuka modal dalam halaman yang menghantar e-mel bergaya kepada satu atau lebih penerima (lihat Perkongsian E-mel di bawah)
• Copy Link — menyalin URL pengesahan ke papan klip
• Embed snippets — menyalin HTML <img> dan <iframe> siap tampal untuk meletakkan lencana di laman web, intranet, atau tandatangan e-mel

Pengesahan QR

Halaman pengesahan khusus memaparkan kod QR yang boleh diimbas dan menghala ke URLnya sendiri — sesuai untuk sijil bercetak, sepanduk acara, atau tangkapan skrin LinkedIn.

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

Sesiapa sahaja yang mengimbas QR dengan kamera telefon akan mendarat di halaman pengesahan langsung, di mana mereka boleh mengesahkan bahawa lencana tersebut dihoskan di badges.ninja, mengikut spesifikasi Open Badge v2.0, dan (pada pelan Pro) ditambat pada rantaian melalui Matchain. Identiti penerima ditunjukkan sebagai cincangan SHA-256 supaya e-mel tidak pernah didedahkan kepada umum.

Sijil PDF

Setiap anugerah mempunyai butang Download Certificate pada halaman pengesahan awam. Mengkliknya akan menjana PDF A4 sedia cetak secara serta-merta yang merangkumi imej lencana, nama penerima, pengeluar, kriteria, tarikh dikeluarkan, tarikh tamat tempoh pilihan, dan kod QR yang menghubungkan kembali ke URL pengesahan langsung.

Pratonton Media Sosial

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

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

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

Perkongsian E-mel

Anda boleh menghantar anugerah lencana melalui e-mel dalam dua cara:

Daripada Halaman Perkongsian Awam

Penerima boleh berkongsi lencana mereka dengan rakan, mentor, atau bakal majikan dengan mengklik Send Email pada halaman perkongsian. Modal akan terbuka di mana mereka memasukkan satu atau lebih alamat e-mel, subjek pilihan, dan mesej peribadi:

Setiap penerima akan menerima e-mel HTML bergaya dengan mesej peribadi penerima dan butang satu klik untuk melihat halaman anugerah awam:

Daripada Papan Pemuka

Pengeluar boleh menghantar mana-mana anugerah melalui e-mel daripada halaman Awards di papan pemuka:

1. Cari anugerah pada halaman Awards.
2. Klik butang Send pada baris tersebut, atau buka modal terperinci dan klik Resend email.
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 kebolehoperasian dengan platform lencana lain, badges.ninja menyediakan JSON Open Badge v2.0 standard di titik akhir awam ini:

Titik Akhir	Penerangan
/certify-badge/issuer/{guid}	JSON profil pengeluar
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (anugerah)

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

Contoh — sahkan satu anugerah:

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 IPFS

Imej lencana disematkan ke IPFS (InterPlanetary File System) melalui pintu masuk kami sendiri, ipfs.ninja. Ini bermaksud:

• Imej adalah kekal dan dialamatkan oleh kandungan — ia tidak boleh diubah suai atau diganti secara senyap
• URL imej dalam JSON Open Badge kelihatan seperti https://ipfs.ninja/ipfs/{cid}
• ID kandungan yang sama boleh diselesaikan melalui mana-mana pintu masuk IPFS awam (cloudflare-ipfs.com, ipfs.io, dll.) — lencana anda tidak terikat kepada satu penyedia sahaja

Oleh kerana imej adalah sebahagian daripada penegasan Open Badge, menggantikan karya seni lencana di kemudian hari tidak akan merosakkan anugerah yang dikeluarkan sebelumnya: CID IPFS lama kekal boleh diselesaikan selama-lamanya, jadi anugerah bersejarah mengekalkan imej asal mereka walaupun anda mereka bentuk semula lencana untuk pengeluaran baharu.