分享與驗證

badges.ninja 上的每筆頒發都有一個公開驗證頁,任何人都可在未登入的情況下存取。接收者可透過社群媒體、電子郵件或複製連結的方式分享徽章。

接收者也有自己的入口

若您透過 badges.ninja 取得徽章,可在 badges.ninja/me 登入(無需密碼),於同一處檢視自己所有的徽章,並在 badges.ninja/u/<您的代稱> 整理一個公開的個人檔案。請參閱 接收者入口。

公開頒發頁

每筆頒發都有一個公開網址:

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

此頁面會顯示徽章圖像(從 IPFS 載入)、徽章名稱與描述、接收者姓名、頒發者名稱與標誌、頒發日期與任何到期日,以及接收者為取得該徽章所符合的條件。任何擁有此連結的人皆可開啟頁面,以確認該認證的真實性。

頒發頁一律會顯示 新增至 LinkedIn 個人檔案 按鈕,讓接收者可以將該認證直接儲存至自己的 LinkedIn 執照與認證清單。(若頒發者已設定 LinkedIn 組織 ID,LinkedIn 會預先填入已驗證的公司頁面;否則會退而使用頒發者的名稱。)單一的 下載 下拉選單提供兩個選項:徽章圖像(原始 PNG,直接來自 IPFS)與 證書(即時於 /certify-badge/award/{guid}/pdf 產生的可列印 A4 PDF)。

公開分享頁

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

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

接收者可由此頁面將徽章分享至:

• LinkedIn —— 將徽章發布至其 LinkedIn 動態(若要將認證直接加入個人檔案,請改用頒發頁上的 新增至 LinkedIn 個人檔案 按鈕)
• Twitter / X —— 發布一則包含徽章連結與自訂分享文字的推文
• Facebook —— 分享至其 Facebook 動態時報
• WhatsApp —— 傳送一則包含徽章連結的訊息
• Telegram —— 傳送一則包含徽章連結的訊息
• Send Email —— 開啟頁內彈出視窗,向一位或多位收件人寄送一封具有樣式的電子郵件(請參閱下方 電子郵件分享)
• Copy Link —— 將驗證網址複製到剪貼簿
• Embed snippets —— 複製可立即貼上的 <img> 與 <iframe> HTML,以便將徽章嵌入網站、企業內部網路或電子郵件簽章

QR 碼驗證

專屬的驗證頁會繪製一張指向其自身網址的可掃描 QR 碼 —— 非常適合用於印製證書、活動橫幅或 LinkedIn 截圖。

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

任何使用手機相機掃描該 QR 碼的人都會進入即時驗證頁,在那裡可以確認該徽章託管於 badges.ninja、遵循 Open Badge v2.0 規範,並且(在 Pro 方案中)透過 Matchain 錨定於鏈上。接收者身分以 SHA-256 雜湊的形式呈現,因此電子郵件位址絕不會被公開揭露。

PDF 證書

每筆頒發都可下載為可列印的 A4 PDF 證書。證書 選項位於公開頒發頁(/awards/{guid})上的 下載 下拉選單中 —— 而非驗證頁,驗證頁僅提供可掃描的 QR 碼與原始的 Open Badge JSON。選擇後會即時(於 /certify-badge/award/{guid}/pdf)產生 PDF,內容包含徽章圖像、接收者姓名、頒發者、條件、頒發日期、選填的到期日,以及一個連回即時驗證網址的 QR 碼。

社群媒體預覽

當徽章連結在 LinkedIn、X、Slack、Facebook、WhatsApp 或電子郵件中被分享時,平台會抓取分享端點,並依據 badges.ninja 提供的 Open Graph 中繼資料繪製一張精美卡片:

• 以徽章圖像作為預覽圖
• 以徽章名稱作為標題
• 描述中包含頒發者名稱與接收者姓名

如此可確保徽章在任何地方分享時皆能呈現專業外觀 —— 接收者無需自行附加圖像或撰寫文案。預覽會由伺服器端在 /certify-badge/award/{guid}/share-html 產生,並於 CDN 邊緣快取,因此即使在首次分享時,預覽也會立即顯示。

電子郵件分享

您可以透過兩種方式以電子郵件寄送徽章頒發:

透過公開分享頁

接收者可點擊分享頁上的 Send Email 按鈕,將徽章分享給朋友、導師或潛在雇主。將會開啟一個彈出視窗,讓他們輸入一個或多個電子郵件位址、選填主旨,以及個人訊息:

每位收件人都會收到一封具有樣式的 HTML 電子郵件,內含接收者的個人訊息以及一個一鍵檢視公開頒發頁的按鈕:

透過儀表板

頒發者可在儀表板的 Awards 頁面以電子郵件寄送任何頒發紀錄:

1. 在 Awards 頁面找到該筆頒發。
2. 點擊該列的 Send 按鈕,或開啟詳細彈出視窗並點擊 Resend email。
3. 輸入收件人電子郵件並寄送。

兩種流程使用同一個電子郵件範本。

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。其他徽章平台與驗證者可以利用此資料來驗證認證。

範例 —— 驗證一筆頒發:

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

{
  "@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"
  }
}

IPFS 圖像網址

徽章圖像會透過我們自家的閘道 ipfs.ninja 釘選至 IPFS(星際檔案系統)。這代表:

• 圖像是永久的且以內容定址 —— 無法被竄改或被悄悄替換
• Open Badge JSON 中的圖像網址形如 https://ipfs.ninja/ipfs/{cid}
• 同一個內容 ID 可透過任何公開 IPFS 閘道(cloudflare-ipfs.com、ipfs.io 等)解析 —— 您的徽章並未被綁定於單一供應商

由於圖像是 Open Badge 斷言的一部分,日後替換徽章美術設計並不會影響先前已頒發的紀錄:舊的 IPFS CID 將永遠可解析,因此即使您為新一輪頒發重新設計徽章,歷史頒發紀錄仍會保留其原始圖像。