整合(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 推送。