分享与验证

badges.ninja 上的每个凭证都有一个公开的验证页面，任何人无需登录即可访问。接收者可以通过社交媒体、电子邮件分享自己的徽章，或复制直接链接。

接收者也有自己的门户

如果你通过 badges.ninja 获得了徽章，可以在 badges.ninja/me 登录（无需密码），在一处查看你的所有徽章，并在 badges.ninja/u/<your-handle> 打造公开个人主页。参阅接收者门户。

公开凭证页面

每个凭证都有一个公开 URL：

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

该页面显示徽章图片、徽章名称和描述、接收者姓名、颁发者名称和徽标、颁发日期及到期日期（如有），以及接收者为获得该徽章所满足的标准。任何拿到链接的人都可以打开该页面，确认凭证真实有效。

公开凭证页面

凭证页面始终显示 Add to LinkedIn profile 按钮，方便接收者将凭证直接保存到其 LinkedIn 的 Licenses & Certifications 中。（如果颁发者设置了 LinkedIn 组织 ID，LinkedIn 会预填已验证的公司主页；否则会回退为颁发者名称。）一个统一的 Download 下拉菜单提供两个选项：Badge image（原始 PNG）和 Certificate（在 /certify-badge/award/{guid}/pdf 即时生成的可打印 A4 PDF）。

公开分享页面

分享页面提供社交分享选项：

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

在此页面上，接收者可以将徽章分享到：

LinkedIn — 将徽章发布到其 LinkedIn 动态（如需将凭证直接添加到个人资料，请改用凭证页面上的 Add to LinkedIn profile 按钮）
Twitter / X — 发布一条包含徽章链接和自定义分享文字的推文
Facebook — 分享到其 Facebook 时间线
WhatsApp — 发送包含徽章链接的消息
Telegram — 发送包含徽章链接的消息
发送电子邮件 — 打开页内弹窗，向一位或多位收件人发送样式精美的电子邮件（参阅下方的电子邮件分享）
复制链接 — 将验证 URL 复制到剪贴板
嵌入代码片段 — 复制可直接粘贴的 <img> 和 <iframe> HTML，将徽章放入网站、内网或邮件签名

二维码验证

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

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

包含徽章信息和可扫描二维码的二维码验证页面

任何人用手机相机扫描二维码，即可进入实时验证页面，确认该徽章托管在 badges.ninja 上并遵循 Open Badge v2.0 规范。接收者身份以 SHA-256 哈希显示，因此电子邮件地址绝不会公开暴露。

PDF 证书

每个凭证都可以下载为可直接打印的 A4 PDF 证书。Certificate 选项位于公开凭证页面（/awards/{guid}）的 Download 下拉菜单中——而不在验证页面上，验证页面只有可扫描的二维码和原始的 Open Badge JSON。选择该选项后，系统会即时生成 PDF（位于 /certify-badge/award/{guid}/pdf），其中包含徽章图片、接收者姓名、颁发者、标准、颁发日期、可选的到期日期，以及指向实时验证 URL 的二维码。

社交媒体预览

当徽章链接在 LinkedIn、X、Slack、Facebook、WhatsApp 或电子邮件中分享时，平台会抓取分享端点，并根据 badges.ninja 输出的 Open Graph 元数据渲染丰富的卡片：

徽章图片作为预览图
徽章名称作为标题
颁发者名称和接收者姓名显示在描述中

这确保了徽章无论在哪里分享都显得专业——接收者无需自行附加图片或撰写文案。预览在服务器端于 /certify-badge/award/{guid}/share-html 生成，并缓存在 CDN 边缘，因此即使首次分享，预览也能立即显示。

电子邮件分享

你可以通过两种方式以电子邮件发送凭证：

从公开分享页面

接收者可以点击分享页面上的 发送电子邮件，与朋友、导师或潜在雇主分享自己的徽章。随后会打开一个弹窗，他们可以在其中输入一个或多个电子邮件地址、可选的主题和一段个人留言：

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

每位收件人都会收到一封样式精美的 HTML 邮件，其中包含接收者的个人留言，以及一个可一键查看公开凭证页面的按钮：

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

从控制面板

颁发者可以在控制面板的 Credentials 页面通过电子邮件发送任意凭证：

在 Credentials 页面找到该凭证。
点击该行上的 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"
  }
}

徽章图片 URL

徽章图片存储在 Amazon S3 上，并通过我们的全球 CDN 以内容寻址的不可变 URL 提供，该 URL 由图片字节的加密哈希（SHA-256）派生而来。这意味着：

图片是永久且按内容寻址的——URL 由字节本身派生，因此无法被篡改或被悄悄替换
Open Badge JSON 中的图片 URL 形如 https://badges.ninja/images/{sha256}.png
图片从 CDN 边缘提供，因此在全球任何地方都加载迅速，并在凭证的整个生命周期内保持可用

由于图片是 Open Badge assertion 的一部分，之后更换徽章图稿不会破坏先前已颁发的凭证：原始图片保留其自身的内容寻址 URL，因此即使你为新的颁发重新设计了徽章，历史凭证依然保留其原始图片。

分享与验证 ​

公开凭证页面 ​

公开分享页面 ​

二维码验证 ​

PDF 证书 ​

社交媒体预览 ​

电子邮件分享 ​

从公开分享页面 ​

从控制面板 ​

Open Badge v2.0 JSON 端点 ​

徽章图片 URL ​

分享与验证

公开凭证页面

公开分享页面

二维码验证

PDF 证书

社交媒体预览

电子邮件分享

从公开分享页面

从控制面板

Open Badge v2.0 JSON 端点

徽章图片 URL