常見問題

關於 badges.ninja 的常見問題。

什麼是數位徽章？

數位徽章是技能、成就或資歷的視覺化、可驗證呈現。每枚徽章都包含中繼資料，說明獲得了什麼、由誰獲得、由誰簽發，以及達成條件。與紙本證書不同，任何人只要擁有徽章 URL 都能線上驗證數位徽章。

badges.ninja 支援哪些 Open Badge 標準？

每筆憑證皆以 Open Badges 2.0 託管 assertion 的形式簽發 — 這是由 IMS Global（現為 1EdTech）制定的業界標準，定義三個核心資料物件：Issuer（簽發者）、BadgeClass（所簽發的內容）與 Assertion（對特定個人的憑證）。任何憑證也都可以匯出為 Open Badges 3.0 / W3C Verifiable Credential（VC-JWT，以我們的 did:web 簽發者金鑰簽署），以便匯入 Verifiable Credential 錢包。同時支援兩者，讓你的徽章可與其他 Open Badge 平台及驗證工具互通，包括 LinkedIn 與 Credly。

徽章圖片是如何儲存的？

徽章圖片託管於 Amazon S3，並透過我們的全球 CDN 以內容定址、不可變的 URL（由圖片的加密雜湊衍生而來）提供。圖片載入快速，並在憑證的整個生命週期中皆保持可用。

免費方案包含什麼？

Free 方案包含 2 個簽發者、5 個徽章類別、每年 1,200 筆憑證、1 個 API 金鑰，並可完整使用整個產品 — 視覺化徽章設計器、永久圖片託管，以及符合 Open Badges 2.0 & 3.0 的功能 — 完全免費，無需信用卡。憑證額度是一個彈性的年度額度池，會於你帳號的註冊週年日重置。

我能用 API 自動建立徽章嗎？

可以。badges.ninja 提供完整的 REST API，可透過程式建立簽發者、徽章與憑證。請於儀表板產生 API 金鑰，並在 X-Api-Key 標頭中帶入。完整範例與文件請參閱 API 參考。

簽發徽章後可以撤銷嗎？

可以。在 憑證 頁面，你可以撤銷單筆憑證（可選填原因，並通知接收者）、一次撤銷多筆，或將其完全刪除。已撤銷的憑證仍可被解析，但其公開驗證頁會顯示該憑證已被撤銷。撤銷會同時反映在 Open Badges 2.0 託管 assertion 以及 Open Badges 3.0 Verifiable Credential 中（透過 W3C Bitstring Status List），因此 VC 錢包也能看到。

接收者在哪裡收取他們的徽章？

接收者可於 badges.ninja/me 無密碼登入，檢視自己獲頒的所有徽章，並可在 badges.ninja/u/<handle> 領取公開個人檔案來展示其憑證。每筆憑證也都有自己的公開驗證頁與分享頁。

批次憑證如何運作？

批次憑證讓你透過上傳一份包含姓名與電子郵件的 CSV 檔案，將同一枚徽章簽發給數百或數千名接收者。系統會逐列處理，即時顯示進度，並允許暫停、恢復或取消。處理完成後可下載成功與失敗憑證的 CSV。完整說明請見 批次憑證。

接收者如何分享他們的徽章？

每筆憑證都有一個公開驗證頁與一個分享頁。接收者可在 LinkedIn、Twitter/X、Facebook、WhatsApp、Telegram 或以電子郵件方式分享徽章，也可直接複製驗證 URL。分享至社群媒體時會附上含徽章圖片與描述的豐富預覽。詳情請見 分享與驗證。

我的資料如何受到保護？

badges.ninja 使用 AWS 基礎架構，資料在儲存與傳輸過程中皆加密。身分驗證由 Amazon Cognito 處理，採用安全的密碼政策。API 金鑰以加密方式產生。徽章圖片採用內容定址（基於雜湊的不可變 URL），並透過 HTTPS 從我們的 CDN 提供。平台遵循安全最佳實務，包含 WAF 防護與 DDoS 緩解。

如何取得支援？

如需協助，請從儀表板側邊欄開啟 支援 頁面。你可以建立支援工單描述問題，團隊會回覆你。你也可以查閱本文件與 快速開始 指南了解常見問題。