常见问题

关于 badges.ninja 的常见问题。

什么是数字徽章?

数字徽章是技能、成就或资质的可视化、可验证凭证。每枚徽章都包含元数据,说明获得了什么、谁获得、由谁颁发以及所需标准。与纸质证书不同,任何人只要拥有徽章 URL,就能在线验证数字徽章。

什么是 Open Badge v2.0 标准?

Open Badge v2.0 是由 IMS Global(现为 1EdTech)制定的行业标准,定义了数字徽章的结构、颁发与验证方式。badges.ninja 遵循该标准,因此你的徽章可以与其他支持 Open Badge 的平台和验证工具互操作。该标准定义了三个核心数据对象:Issuer(颁发者)、BadgeClass(所授内容)与 Assertion(针对具体个人的颁发)。

IPFS 存储是如何工作的?

徽章图片存储在 IPFS(InterPlanetary File System),这是一个去中心化存储网络。图片上传后采用内容寻址 —— 通过内容的加密哈希进行标识。这使它们具有永久性、抗篡改,并可通过任何 IPFS 网关访问。即使 badges.ninja 离线,你的徽章图片依然可用。

免费方案包含什么?

Free 方案包含 2 个颁发者、5 个徽章类别、每月 100 次颁发、1 个 API 密钥、1 GB 的徽章图片存储,并可完整使用可视化徽章设计器、IPFS 存储与 Open Badge v2.0 合规功能 —— 完全免费,无需信用卡。每月初,颁发额度会自动重置。

我能用 API 自动创建徽章吗?

可以。badges.ninja 提供完整的 REST API,用于以程序方式创建颁发者、徽章和颁发记录。在仪表板中生成 API 密钥,并在 X-Api-Key 请求头中传入。完整示例与文档请查阅 API 参考。

什么是区块链验证?

区块链验证是一项为 Pro 方案预留的可选功能,可将颁发记录上链(通过 Matchain 网络),在标准的托管验证之外提供额外的真实性证明。链上锚定尚未上线 —— 目前颁发记录通过托管的公开验证页记录与验证。

我颁发徽章后还能撤销吗?

可以。在 颁发记录 页面,你可以撤销单条颁发记录(可选择填写原因,并通知接收者),或将其彻底删除。被撤销的颁发记录仍可解析,但其公开验证页会显示该凭证已被撤销。这遵循 Open Badge v2.0 的撤销模型。

接收者在哪里领取徽章?

接收者可在 badges.ninja/me 无密码登录,查看已获得的每一枚徽章,并可在 badges.ninja/u/<handle> 认领公开主页以展示其凭证。每次颁发也都有各自的公开验证与分享页。

批量颁发如何工作?

批量颁发可让你通过上传一份包含姓名和邮箱的 CSV 文件,向成百上千的接收者颁发同一枚徽章。系统逐行处理,实时显示进度,并允许暂停、恢复或取消。处理完成后可下载成功和失败的 CSV。详细指南见 批量颁发。

接收者如何分享徽章?

每次颁发都有一个公开验证页和一个分享页。接收者可在 LinkedIn、Twitter/X、Facebook、WhatsApp、Telegram 或通过邮件分享徽章。他们也可以直接复制验证 URL。分享到社交媒体时会包含带有徽章图片和描述的富预览。详情参见 分享与验证。

我的数据如何得到保护?

badges.ninja 运行在 AWS 基础设施上,数据在存储和传输过程中均加密。身份认证由 Amazon Cognito 处理,采用安全的密码策略。API 密钥通过加密方式生成。IPFS 上的徽章图片采用内容寻址,无法被篡改。平台遵循最佳安全实践,包括 WAF 防护和 DDoS 缓解。

如何获得支持?

如需帮助,请在仪表板侧边栏打开 支持 页面。你可以创建支持工单描述问题,团队会作出回复。另外也可以查阅本文档和 快速开始 指南,了解常见问题。