Chia sẻ & Xác thực

Mỗi lần cấp trên badges.ninja đều có một trang xác thực công khai mà ai cũng có thể truy cập mà không cần đăng nhập. Người nhận có thể chia sẻ huy hiệu của mình trên mạng xã hội, qua email, hoặc bằng cách sao chép liên kết trực tiếp.

Người nhận cũng có cổng riêng

Nếu bạn đã đạt được một huy hiệu thông qua badges.ninja, bạn có thể đăng nhập (không cần mật khẩu) tại badges.ninja/me để xem tất cả huy hiệu của mình ở một nơi và tạo hồ sơ công khai tại badges.ninja/u/<tên-người-dùng>. Xem Cổng dành cho Người nhận.

Trang Cấp Công Khai

Mỗi lần cấp đều có một URL công khai:

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

Trang này hiển thị hình ảnh huy hiệu (được tải từ IPFS), tên và mô tả của huy hiệu, tên người nhận, tên và logo của bên cấp, ngày cấp và ngày hết hạn nếu có, cùng các tiêu chí mà người nhận đã đáp ứng để đạt được huy hiệu. Bất kỳ ai có liên kết đều có thể mở trang để xác nhận chứng chỉ là xác thực.

Nếu bên cấp đã thiết lập ID tổ chức LinkedIn, nút Thêm vào hồ sơ LinkedIn sẽ hiện ra để người nhận có thể lưu chứng chỉ trực tiếp vào mục Licenses & Certifications của LinkedIn. Nút Tải Huy Hiệu cung cấp hình ảnh huy hiệu gốc (trực tiếp từ IPFS), và nút Tải PDF tạo một chứng chỉ A4 sẵn sàng để in một cách tức thời.

Trang Chia Sẻ Công Khai

Trang chia sẻ cung cấp các tùy chọn chia sẻ trên mạng xã hội:

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

Từ trang này, người nhận có thể chia sẻ huy hiệu của mình trên:

• LinkedIn — đăng lên dòng thời gian LinkedIn của họ, hoặc thêm chứng chỉ trực tiếp vào hồ sơ qua nút Add to LinkedIn Profile (khi bên cấp đã thiết lập ID tổ chức LinkedIn)
• Twitter / X — đăng một tweet kèm liên kết huy hiệu và văn bản chia sẻ tùy chỉnh
• Facebook — chia sẻ trên dòng thời gian Facebook của họ
• WhatsApp — gửi tin nhắn kèm liên kết huy hiệu
• Telegram — gửi tin nhắn kèm liên kết huy hiệu
• Send Email — mở một cửa sổ modal trên trang để gửi email được tạo kiểu cho một hoặc nhiều người nhận (xem Chia sẻ qua Email bên dưới)
• Copy Link — sao chép URL xác thực vào clipboard
• Embed snippets — sao chép HTML <img> và <iframe> sẵn sàng để dán nhằm đặt huy hiệu vào một trang web, mạng nội bộ hoặc chữ ký email

Xác thực bằng QR

Một trang xác thực chuyên dụng hiển thị một mã QR có thể quét được, chỉ tới chính URL của nó — hoàn hảo cho chứng chỉ in, băng-rôn sự kiện hoặc ảnh chụp màn hình LinkedIn.

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

Bất kỳ ai quét mã QR bằng camera điện thoại sẽ truy cập trang xác thực trực tiếp, nơi họ có thể xác nhận huy hiệu được lưu trữ trên badges.ninja, tuân theo đặc tả Open Badge v2.0, và (đối với gói Pro) được neo trên chuỗi qua Matchain. Danh tính của người nhận được hiển thị dưới dạng hash SHA-256 nên email không bao giờ bị lộ công khai.

Chứng chỉ PDF

Mỗi lần cấp đều có nút Download Certificate trên trang xác thực công khai. Nhấp vào sẽ tạo một PDF A4 sẵn sàng để in một cách tức thời, bao gồm hình ảnh huy hiệu, tên người nhận, bên cấp, tiêu chí, ngày cấp, ngày hết hạn tùy chọn và một mã QR liên kết về URL xác thực trực tiếp.

Xem trước trên Mạng Xã Hội

Khi liên kết huy hiệu được chia sẻ trên LinkedIn, X, Slack, Facebook, WhatsApp hoặc qua email, nền tảng sẽ truy xuất endpoint chia sẻ và hiển thị một thẻ phong phú từ siêu dữ liệu Open Graph mà badges.ninja phát ra:

• Hình ảnh huy hiệu làm hình xem trước
• Tên huy hiệu làm tiêu đề
• Tên bên cấp và tên người nhận trong phần mô tả

Điều này đảm bảo huy hiệu trông chuyên nghiệp khi được chia sẻ ở bất cứ đâu — người nhận không cần phải đính kèm hình ảnh riêng hoặc viết nội dung. Bản xem trước được tạo phía máy chủ tại /certify-badge/award/{guid}/share-html và được lưu cache tại biên CDN, nên các bản xem trước xuất hiện ngay lập tức ngay cả ở lần chia sẻ đầu tiên.

Chia sẻ qua Email

Bạn có thể gửi các lần cấp huy hiệu qua email theo hai cách:

Từ Trang Chia Sẻ Công Khai

Người nhận có thể chia sẻ huy hiệu của mình với bạn bè, người cố vấn hoặc nhà tuyển dụng tiềm năng bằng cách nhấp Send Email trên trang chia sẻ. Một modal sẽ mở ra, nơi họ nhập một hoặc nhiều địa chỉ email, một chủ đề tùy chọn và một thông điệp cá nhân:

Mỗi người nhận sẽ nhận được một email HTML được tạo kiểu kèm thông điệp cá nhân của người nhận và một nút bấm-một-lần để xem trang cấp công khai:

Từ Bảng Điều Khiển

Bên cấp có thể gửi bất kỳ lần cấp nào qua email từ trang Awards trong bảng điều khiển:

1. Tìm lần cấp trên trang Awards.
2. Nhấp nút Send trên hàng đó, hoặc mở modal chi tiết và nhấp Resend email.
3. Nhập email người nhận và gửi.

Cùng một mẫu email được sử dụng cho cả hai luồng.

Endpoint JSON Open Badge v2.0

Để khả năng tương tác với các nền tảng huy hiệu khác, badges.ninja cung cấp JSON Open Badge v2.0 chuẩn tại các endpoint công khai sau:

Endpoint	Mô tả
/certify-badge/issuer/{guid}	JSON hồ sơ bên cấp
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (lần cấp)

Các endpoint này trả về JSON-LD tuân thủ đặc tả Open Badge v2.0. Các nền tảng huy hiệu khác và các bên xác thực có thể sử dụng dữ liệu này để xác nhận chứng chỉ.

Ví dụ — xác thực một lần cấp:

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 Hình Ảnh trên IPFS

Hình ảnh huy hiệu được ghim vào IPFS (InterPlanetary File System) thông qua cổng riêng của chúng tôi, ipfs.ninja. Điều này có nghĩa:

• Hình ảnh là vĩnh viễn và được định địa chỉ theo nội dung — chúng không thể bị giả mạo hoặc thay thế âm thầm
• URL hình ảnh trong JSON Open Badge có dạng https://ipfs.ninja/ipfs/{cid}
• Cùng một content-ID có thể được phân giải qua bất kỳ cổng IPFS công khai nào (cloudflare-ipfs.com, ipfs.io, v.v.) — huy hiệu của bạn không bị khóa vào một nhà cung cấp duy nhất

Vì hình ảnh là một phần của khẳng định Open Badge, việc thay thế thiết kế huy hiệu sau này không làm hỏng các lần cấp đã phát hành trước đó: CID IPFS cũ vẫn có thể phân giải mãi mãi, vì vậy các lần cấp lịch sử vẫn giữ được hình ảnh gốc của chúng ngay cả khi bạn thiết kế lại huy hiệu cho các đợt cấp mới.