分享与验证

badges.ninja 上的每次颁发都有一个公开验证页,无需登录即可访问。接收者可以通过社交媒体、邮件或直接复制链接来分享自己的徽章。

接收者也有自己的门户

如果你通过 badges.ninja 获得了徽章,可以在 badges.ninja/me 登录(无需密码),在一个地方查看你的所有徽章,并在 badges.ninja/u/<你的用户名> 整理一个公开的个人主页。参见接收者门户。

公开颁发页

每次颁发都有一个公开 URL:

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

该页面会展示徽章图片(从 IPFS 加载)、徽章名称与描述、接收者姓名、颁发方名称与徽标、颁发日期及任何过期日期,以及接收者为获得徽章所满足的条件。任何持有该链接的人都可以打开此页面,以确认该证书的真实性。

公开颁发页

如果颁发方设置了 LinkedIn 组织 ID,添加到 LinkedIn 个人资料 按钮会出现,接收者可以将该证书直接保存到自己的 LinkedIn 执照与认证中。下载徽章 按钮提供原始徽章图片(直接来自 IPFS),而 下载 PDF 则会即时生成一份可打印的 A4 证书。

公开分享页

分享页提供社交分享选项:

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

接收者可以从该页面将其徽章分享到:

LinkedIn —— 发布到他们的 LinkedIn 动态,或通过 Add to LinkedIn Profile 按钮将证书直接添加到个人资料(在颁发方已设置 LinkedIn 组织 ID 时)
Twitter / X —— 发布一条带有徽章链接和自定义分享文本的推文
Facebook —— 在他们的 Facebook 时间线上分享
WhatsApp —— 发送带有徽章链接的消息
Telegram —— 发送带有徽章链接的消息
Send Email —— 打开页内弹窗,向一位或多位收件人发送一封带样式的邮件(参见下文邮件分享)
Copy Link —— 将验证 URL 复制到剪贴板
Embed snippets —— 复制可直接粘贴的 <img> 与 <iframe> HTML,用于将徽章嵌入网站、内部网或邮件签名

QR 码验证

专用验证页会渲染一个指向其自身 URL 的可扫描二维码 —— 非常适合用于打印证书、活动横幅或 LinkedIn 截图。

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

包含徽章身份、区块链证明与可扫描二维码的 QR 验证页

任何使用手机相机扫描该二维码的人都会进入实时验证页,在那里可以确认该徽章托管在 badges.ninja 上、遵循 Open Badge v2.0 规范,并且(在 Pro 套餐下)通过 Matchain 锚定到链上。接收者身份以 SHA-256 哈希的形式呈现,因此邮箱永远不会被公开暴露。

PDF 证书

每次颁发在公开验证页上都有一个 Download Certificate 按钮。点击后会即时生成一份可打印的 A4 PDF,包含徽章图片、接收者姓名、颁发方、条件、颁发日期、可选的过期日期,以及一个回链到实时验证 URL 的二维码。

社交媒体预览

当徽章链接在 LinkedIn、X、Slack、Facebook、WhatsApp 或邮件中被分享时,平台会获取分享端点,并根据 badges.ninja 输出的 Open Graph 元数据渲染一张精美卡片:

徽章图片作为预览图
徽章名称作为标题
描述中包含颁发方名称和接收者姓名

这能确保徽章在任何地方分享时都显得专业 —— 接收者无需附带自己的图片或撰写文案。预览在服务器端通过 /certify-badge/award/{guid}/share-html 生成,并在 CDN 边缘缓存,因此即使在首次分享时,预览也会立即显示。

邮件分享

你可以通过两种方式发送徽章颁发邮件:

通过公开分享页

接收者可以通过点击分享页上的 Send Email 按钮,与朋友、导师或潜在雇主分享自己的徽章。会弹出一个对话框,他们可以输入一个或多个邮箱地址、可选的主题以及个人留言:

页内发送邮件弹窗 —— 接收者输入地址、主题和个人留言

每位收件人都会收到一封带样式的 HTML 邮件,内含接收者的个人留言以及一个一键查看公开颁发页的按钮:

每位收件人实际收到的邮件

通过仪表盘

颁发方可以在仪表盘的 Awards 页面通过邮件发送任何颁发记录:

在 Awards 页面找到该颁发记录。
点击该行的 Send 按钮,或打开详情弹窗并点击 Resend email。
输入收件人邮箱并发送。

两种流程使用同一份邮件模板。

Open Badge v2.0 JSON 端点

为了与其他徽章平台互操作,badges.ninja 在以下公开端点提供标准的 Open Badge v2.0 JSON:

端点	描述
`/certify-badge/issuer/{guid}`	颁发方资料 JSON
`/certify-badge/badge/{guid}`	BadgeClass JSON
`/certify-badge/award/{guid}`	Assertion JSON(颁发记录)

这些端点返回符合 Open Badge v2.0 规范的 JSON-LD。其他徽章平台和验证方可以使用这些数据来校验证书。

示例 —— 验证一次颁发:

bash

curl https://api.badges.ninja/certify-badge/award/abc123-def456

json

{
  "@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"
  }
}

IPFS 图片 URL

徽章图片通过我们自己的网关 ipfs.ninja 固定在 IPFS(星际文件系统)上。这意味着:

图片是永久的、按内容寻址的 —— 无法被篡改或被悄悄替换
Open Badge JSON 中的图片 URL 形如 https://ipfs.ninja/ipfs/{cid}
同一个内容 ID 可以通过任何公开 IPFS 网关(cloudflare-ipfs.com、ipfs.io 等)解析 —— 你的徽章并未被锁定在单一服务商上

由于图片是 Open Badge 断言的一部分,稍后替换徽章图样不会影响此前已经颁发的记录:旧的 IPFS CID 会永久可解析,因此即便你为新颁发重新设计徽章,历史颁发记录仍然保留其原始图片。

分享与验证 ​

公开颁发页 ​

公开分享页 ​

QR 码验证 ​

PDF 证书 ​

社交媒体预览 ​

邮件分享 ​

通过公开分享页 ​

通过仪表盘 ​

Open Badge v2.0 JSON 端点 ​

IPFS 图片 URL ​

分享与验证

公开颁发页

公开分享页

QR 码验证

PDF 证书

社交媒体预览

邮件分享

通过公开分享页

通过仪表盘

Open Badge v2.0 JSON 端点

IPFS 图片 URL