Chia sẻ và xác minh

Mỗi chứng chỉ trên badges.ninja đều có một trang xác minh công khai mà bất kỳ 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 đã nhận được huy hiệu 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/<your-handle>. Xem Cổng người nhận.

Trang chứng chỉ công khai

Mỗi chứng chỉ có một URL công khai:

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

Trang này hiển thị hình ảnh huy hiệu, tên và mô tả huy hiệu, tên người nhận, tên và logo của tổ chức 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.

Trang chứng chỉ luôn hiển thị nút Add to LinkedIn profile để người nhận có thể lưu chứng chỉ trực tiếp vào mục Licenses & Certifications trên LinkedIn của mình. (Nếu tổ chức cấp đã thiết lập ID tổ chức LinkedIn, LinkedIn sẽ tự điền Trang công ty đã xác minh; nếu không, LinkedIn sẽ dùng tên của tổ chức cấp.) Một menu thả xuống Download duy nhất cung cấp hai lựa chọn: Badge image (tệp PNG gốc) và Certificate (tệp PDF khổ A4 để in, được tạo tức thì tại /certify-badge/award/{guid}/pdf).

Trang chia sẻ công khai

Trang chia sẻ cung cấp các tùy chọn chia sẻ lê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 lên:

• LinkedIn — đăng huy hiệu lên bảng tin LinkedIn của họ (để thêm chứng chỉ trực tiếp vào hồ sơ, hãy dùng nút Add to LinkedIn profile trên trang chứng chỉ)
• Twitter / X — đăng một tweet kèm liên kết huy hiệu và nội dung chia sẻ tùy chỉnh
• Facebook — chia sẻ lê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
• Gửi email — mở một cửa sổ modal ngay trên trang để gửi email được định dạng đẹp tới một hoặc nhiều người nhận (xem Chia sẻ qua email bên dưới)
• Sao chép liên kết — sao chép URL xác minh vào bộ nhớ tạm
• Đoạn mã nhúng — sao chép mã HTML <img> và <iframe> sẵn sàng dán để đặt huy hiệu vào website, mạng nội bộ hoặc chữ ký email

Xác minh bằng mã QR

Một trang xác minh riêng hiển thị mã QR quét được, trỏ tới chính URL của trang — rất phù hợp cho chứng nhận in, banner 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ẽ được đưa tới trang xác minh trực tiếp, nơi họ có thể xác nhận huy hiệu được lưu trữ trên badges.ninja và tuân theo đặc tả Open Badge v2.0. Danh tính người nhận được hiển thị dưới dạng mã băm SHA-256 nên email không bao giờ bị lộ công khai.

Chứng nhận PDF

Mọi chứng chỉ đều có thể được tải xuống dưới dạng chứng nhận PDF khổ A4 sẵn sàng để in. Tùy chọn Certificate nằm trong menu thả xuống Download trên trang chứng chỉ công khai (/awards/{guid}) — không nằm trên trang xác minh, vốn chỉ có mã QR quét được và JSON Open Badge thô. Khi chọn, tệp PDF được tạo tức thì (tại /certify-badge/award/{guid}/pdf) với hình ảnh huy hiệu, tên người nhận, tổ chức cấp, tiêu chí, ngày cấp, ngày hết hạn (tùy chọn) và mã QR dẫn về URL xác minh 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 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 cung cấp:

• Hình ảnh huy hiệu làm ảnh xem trước
• Tên huy hiệu làm tiêu đề
• Tên tổ chức 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 tự đính kèm hình ảnh hay 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 đệm ở rìa CDN, nên 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 chứng chỉ 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 Gửi email trên trang chia sẻ. Một cửa sổ modal sẽ mở ra để họ nhập một hoặc nhiều địa chỉ email, tiêu đề tùy chọn và một lời nhắn cá nhân:

Mỗi người nhận email sẽ nhận được một email HTML được định dạng đẹp kèm lời nhắn cá nhân của người chia sẻ và một nút để xem trang chứng chỉ công khai chỉ bằng một cú nhấp:

Từ bảng điều khiển

Các tổ chức cấp có thể gửi bất kỳ chứng chỉ nào qua email từ trang Credentials trong bảng điều khiển:

1. Tìm chứng chỉ trên trang Credentials.
2. Nhấp nút Send trên dòng đó, hoặc mở cửa sổ chi tiết và nhấp Resend email.
3. Nhập email người nhận rồi gửi.

Cả hai luồng đều dùng chung một mẫu email.

Các endpoint JSON Open Badge v2.0

Để tương thích 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ơ tổ chức cấp
/certify-badge/badge/{guid}	JSON BadgeClass
/certify-badge/award/{guid}	JSON Assertion (chứng chỉ)

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 và công cụ xác minh khác có thể dùng dữ liệu này để xác thực chứng chỉ.

Ví dụ — xác minh một chứng chỉ:

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 huy hiệu

Hình ảnh huy hiệu được lưu trên Amazon S3 và phân phối qua CDN toàn cầu của chúng tôi dưới một URL bất biến, định địa chỉ theo nội dung, được tạo từ mã băm mật mã (SHA-256) của các byte hình ảnh. Điều này có nghĩa là:

• Hình ảnh là vĩnh viễn và được định địa chỉ theo nội dung — URL được tạo từ chính các byte, nên không thể bị giả mạo hoặc âm thầm thay thế
• URL hình ảnh trong JSON Open Badge có dạng https://badges.ninja/images/{sha256}.png
• Hình ảnh được phân phối từ rìa CDN, nên tải nhanh ở mọi nơi trên thế giới và luôn khả dụng trong suốt vòng đời của chứng chỉ

Vì hình ảnh là một phần của assertion Open Badge, việc thay đổi hình ảnh huy hiệu sau này không làm hỏng các chứng chỉ đã cấp trước đó: hình ảnh gốc giữ nguyên URL định địa chỉ theo nội dung của nó, nên các chứng chỉ cũ vẫn giữ hình ảnh ban đầu ngay cả khi bạn thiết kế lại huy hiệu cho các lần cấp mới.