集成(Zapier、Make 及更多)

将 badges.ninja 连接到你已在使用的工具——当别处发生某事时自动颁发凭证,并在凭证被颁发、送达、撤销或查看时实时做出反应。任何支持 REST 和 webhooks 的平台都可以;Zapier 和 Make 最为快捷。

你可以自动化什么

触发器(badges.ninja → 你的工具)——在以下情况触发工作流:

• 凭证被颁发
• 凭证被送达(其邮件已发送)
• 凭证被撤销
• 凭证被首次查看

动作(你的工具 → badges.ninja):

• 颁发凭证——向接收者授予徽章

前提条件

1. 在仪表板的 API 密钥 下创建一个 API 密钥。动作(颁发)使用读写密钥;仅用于触发器则只读密钥即可。参见 API 密钥。
2. 就这样——一切都通过 REST API 和 webhooks 运行。

Zapier

一旦连接了 badges.ninja Zapier 应用:

1. 连接你的账户——在提示时粘贴你的 API 密钥。
2. 选择一个触发器(例如 Credential Issued)或 Issue Credential 动作。
3. 映射字段并开启该 Zap。

在底层,触发器使用 Zapier 的 REST Hook 模型,由 Webhooks API 支撑:Zapier 通过 POST /webhooks 订阅,badges.ninja 实时向它投递事件,因此没有轮询延迟。

Make(Integromat)与自定义平台

无需应用——直接连线:

1. 在每个请求上使用 X-Api-Key 请求头进行 认证。
2. 通过注册你的端点 订阅 事件:

   curl -X POST https://api.badges.ninja/webhooks \
     -H "X-Api-Key: bws_your_api_key_here" \
     -H "Content-Type: application/json" \
     -d '{ "url": "https://hook.example.com/badges", "events": ["credential.issued"] }'

3. 在你的端点 接收 已签名的投递。验证 X-Bws-Signature 请求头——参见 Webhooks。
4. 通过调用 POST /awards 颁发凭证——参见 Awards API。

参考

• Webhooks API — 事件、载荷、签名、重试
• Awards API — 颁发凭证
• API 密钥 — 密钥与访问范围

Zapier 应用源码位于仓库的 integrations/zapier/ 下,可使用 Zapier CLI 推送。