分享與驗證

badges.ninja 上的每一張憑證都有公開的驗證頁面，任何人無需登入即可存取。接收者可以將徽章分享到社群媒體、透過電子郵件寄送，或複製直接連結。

接收者也有專屬入口網站

如果您透過 badges.ninja 取得了徽章，可以在 badges.ninja/me 登入（無需密碼），在同一處查看所有徽章，並在 badges.ninja/u/<your-handle> 設定公開個人檔案。請參閱接收者入口網站。

公開憑證頁

每張憑證都有一個公開網址：

https://badges.ninja/awards/{guid}

此頁面會顯示徽章圖片、徽章名稱與說明、接收者姓名、簽發者名稱與標誌、簽發日期與到期日（如有），以及接收者為獲得徽章所達成的條件。任何持有連結的人都可以開啟此頁面，確認憑證的真實性。

Public credential page

憑證頁面一律會顯示 Add to LinkedIn profile 按鈕，讓接收者可以直接將憑證儲存到 LinkedIn 的「證照」欄位。（如果簽發者設定了 LinkedIn 組織 ID，LinkedIn 會預先帶入已驗證的公司專頁；否則會改用簽發者名稱。）單一的下載下拉選單提供兩個選項：徽章圖片（原始 PNG）與證書（透過 /certify-badge/award/{guid}/pdf 即時產生、可列印的 A4 PDF）。

公開分享頁

分享頁提供社群分享選項：

https://badges.ninja/awards/{guid}/share

在此頁面，接收者可以將徽章分享到：

LinkedIn — 將徽章張貼到其 LinkedIn 動態（若要將憑證直接加入個人檔案，請改用憑證頁面上的 Add to LinkedIn profile 按鈕）
Twitter / X — 發佈包含徽章連結與自訂分享文字的推文
Facebook — 分享到其 Facebook 動態時報
WhatsApp — 傳送包含徽章連結的訊息
Telegram — 傳送包含徽章連結的訊息
傳送電子郵件 — 開啟頁面內的視窗，將精美排版的電子郵件寄給一位或多位收件者（請見下方的透過電子郵件分享）
複製連結 — 將驗證網址複製到剪貼簿
嵌入程式碼片段 — 複製可直接貼上的 <img> 與 <iframe> HTML，將徽章放入網站、內部網路或電子郵件簽名檔

QR 碼驗證

專屬的驗證頁面會顯示指向自身網址的可掃描 QR 碼 — 非常適合用於印刷證書、活動看板或 LinkedIn 截圖。

https://badges.ninja/verify/{guid}

QR verification page with badge identity and scannable QR code

任何人使用手機相機掃描 QR 碼，即可進入即時驗證頁面，確認該徽章託管於 badges.ninja，並符合 Open Badge v2.0 規範。接收者身分以 SHA-256 雜湊值顯示，因此電子郵件地址絕不會公開外洩。

PDF 證書

每張憑證都可以下載為可直接列印的 A4 PDF 證書。證書選項位於公開憑證頁（/awards/{guid}）的下載下拉選單中 — 驗證頁面上沒有此選項，該頁面僅提供可掃描的 QR 碼與原始 Open Badge JSON。選擇後會即時產生 PDF（透過 /certify-badge/award/{guid}/pdf），內容包含徽章圖片、接收者姓名、簽發者、條件、簽發日期、選填的到期日，以及連回即時驗證網址的 QR 碼。

社群媒體預覽

當徽章連結被分享到 LinkedIn、X、Slack、Facebook、WhatsApp 或電子郵件時，平台會擷取分享端點，並根據 badges.ninja 輸出的 Open Graph 中繼資料顯示豐富的預覽卡片：

以徽章圖片作為預覽圖
以徽章名稱作為標題
在說明中顯示簽發者名稱與接收者姓名

這能確保徽章無論分享到何處都呈現專業的外觀 — 接收者不需要自行附上圖片或撰寫文案。預覽在伺服器端透過 /certify-badge/award/{guid}/share-html 產生，並快取於 CDN 邊緣節點，因此即使是第一次分享，預覽也能立即顯示。

透過電子郵件分享

您可以用兩種方式透過電子郵件寄送憑證：

從公開分享頁

接收者可以點擊分享頁上的傳送電子郵件，將徽章分享給朋友、導師或潛在雇主。畫面會開啟一個視窗，讓他們輸入一個或多個電子郵件地址、選填的主旨，以及個人訊息：

In-page send email modal — recipients enter addresses, subject, and a personal note

每位收件者都會收到一封精美排版的 HTML 電子郵件，內含接收者的個人訊息，以及一個可一鍵檢視公開憑證頁的按鈕：

The actual email each addressee receives

從儀表板

簽發者可以在儀表板的「憑證」頁面，透過電子郵件寄送任何憑證：

在「憑證」頁面找到該憑證。
點擊該列的傳送按鈕，或開啟詳細資料視窗後點擊重新寄送電子郵件。
輸入接收者的電子郵件地址並傳送。

兩種方式使用相同的電子郵件範本。

Open Badge v2.0 JSON 端點

為了與其他徽章平台互通，badges.ninja 在以下公開端點提供標準的 Open Badge v2.0 JSON：

端點	說明
`/certify-badge/issuer/{guid}`	簽發者檔案 JSON
`/certify-badge/badge/{guid}`	BadgeClass JSON
`/certify-badge/award/{guid}`	Assertion JSON（憑證）

這些端點回傳符合 Open Badge v2.0 規範的 JSON-LD。其他徽章平台與驗證工具可以使用這些資料來驗證憑證。

範例 — 驗證憑證：

bash

curl https://api.badges.ninja/certify-badge/award/abc123-def456

json

{
  "@context": "https://w3id.org/openbadges/v2",
  "type": "Assertion",
  "id": "https://api.badges.ninja/certify-badge/award/abc123-def456",
  "recipient": {
    "type": "email",
    "identity": "sha256$..."
  },
  "badge": "https://api.badges.ninja/certify-badge/badge/xyz789",
  "issuedOn": "2025-01-15T00:00:00.000Z",
  "verification": {
    "type": "hosted"
  }
}

徽章圖片網址

徽章圖片儲存在 Amazon S3，並透過我們的全球 CDN，以由圖片位元組的加密雜湊值（SHA-256）衍生的內容定址、不可變網址提供。這表示：

圖片是永久且以內容定址的 — 網址由位元組本身衍生，因此無法被竄改或在不知不覺中被替換
Open Badge JSON 中的圖片網址格式為 https://badges.ninja/images/{sha256}.png
圖片由 CDN 邊緣節點提供，因此在世界各地都能快速載入，並在憑證的整個存續期間保持可用

由於圖片是 Open Badge assertion 的一部分，日後更換徽章圖樣並不會影響先前已簽發的憑證：原始圖片保有其專屬的內容定址網址，因此即使您為新的簽發重新設計了徽章，歷史憑證仍會保留其原始圖片。

分享與驗證 ​

公開憑證頁 ​

公開分享頁 ​

QR 碼驗證 ​

PDF 證書 ​

社群媒體預覽 ​

透過電子郵件分享 ​

從公開分享頁 ​

從儀表板 ​

Open Badge v2.0 JSON 端點 ​

徽章圖片網址 ​