API 金鑰

API 金鑰可讓你以程式方式存取 badges.ninja REST API。透過 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/mo)	5
Pro ($29/mo)	20

刪除金鑰

1. 開啟 API 金鑰 頁面。
2. 找到要刪除的金鑰。
3. 點按 刪除。
4. 確認刪除。

金鑰一經刪除立即失效。任何使用該金鑰的應用程式都會收到驗證錯誤。