API 密钥

API 密钥让你以编程方式访问 badges.ninja 的 REST API。使用它们可在你自己的应用中自动化徽章的创建、颁发和管理。

创建 API 密钥

1. 在侧边栏打开 API 密钥 页面。
2. 点击 创建 API 密钥,内嵌表单打开:

3. 给密钥起个名字并点击 创建。完整密钥会在绿色横幅上 仅显示一次:

4. 请立刻复制密钥 — 它只显示一次。一旦丢失,必须重新创建。关闭横幅后只会保存前缀:

密钥格式

API 密钥使用 bws_ 前缀,后接 32 个字符的十六进制串:

bws_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

在请求中使用 API 密钥

在每个 API 请求的 X-Api-Key 头中包含 API 密钥:

curl -X GET https://api.badges.ninja/issuers \
  -H "X-Api-Key: bws_your_api_key_here"

请参阅 认证 页面了解 API 认证的完整细节。

各套餐的密钥限制

可创建的 API 密钥数量取决于你的套餐:

套餐	API 密钥上限
Free	1
Starter(9 美元/月)	5
Pro(29 美元/月)	20

删除密钥

1. 打开 API 密钥 页面。
2. 找到要删除的密钥。
3. 点击 删除。
4. 确认删除。

删除后,密钥立即失效。仍在使用该密钥的任何应用都会收到认证错误。