Open Badge 的到期與續期:限時憑證的生命週期管理
繼續教育學分、認證和執照都會到期。為 Open Badges 設定 expirationDate,並以程式方式續期。資料結構 + 工作流程。
有些憑證是終身有效的。學位不會因為過了十年就變得不真實。但訓練團隊所簽發的憑證中,有相當一部分恰恰相反:兩年有效的資安認證、每年一次的堆高機安全複訓、CPR 證書、只在一個報告週期內有效的繼續教育學分。這類憑證表明的是某人在某個日期具備相應能力,而這個聲明是有保存期限的。
如果你的數位憑證永不到期,你其實是在悄悄地向雇主和稽核人員傳遞一個不真實的訊息。本文將介紹 Open Badges 中到期是如何運作的、憑證失效時驗證者會看到什麼,以及一套實用的續期工作流程——除非你想寫程式,否則完全不需要。
開始之前的一點命名說明
你會看到有人搜尋 “expirationDate”。在 Open Badges v2.0 規範中,斷言(assertion,即簽發本身,有別於徽章類別 badge class)上的欄位叫做 expires。它是一個 ISO 8601 日期時間字串。在 https://badges.ninja 簽發憑證時你傳送的 API 欄位也叫 expires。意思相同,只是名稱和大多數人猜的不一樣,所以在閱讀 JSON-LD 文件或查閱文件時請記住這一點。
有兩點值得了解:
- 到期時間屬於簽發紀錄,而不是徽章本身。同一枚徽章(例如「年度安全訓練」)可以簽發給一個人並設定在 3 月到期,簽發給另一個人則在 9 月到期。這正是你想要的,因為有效期是從每個人完成訓練的時間開始計算的。
- 它是選填的。不設定,憑證就永不到期。
簽發時設定到期時間
設定有效期有三種方式。先從前兩種開始,因為它們不需要寫程式。
控制台表單。 建立憑證時,表單中接收者姓名和電子郵件旁邊有一個選填的 “Expires” 日期欄位。選好日期,然後簽發即可。就這麼簡單。

批次簽發。 如果你要向整個班級簽發,批次簽發頁面接受包含接收者的 CSV 檔案,並對整批套用同一個到期日期,因此同一週結業的班級會有相同的失效日期。大批量作業可以暫停與繼續。我們關於透過 CSV 簽發 Open Badges 的教學說明了檔案格式。
API。 對於自動化情境,例如學習管理系統在某人通過考試時觸發 hook 來簽發憑證,請在 POST /awards 的請求本文中加入 expires。它接受與 issuedOn 相同的格式:epoch 毫秒數或 ISO 日期字串。
// Issue a 2-year certification
const issuedOn = Date.now();
const twoYears = 2 * 365 * 24 * 60 * 60 * 1000;
const res = await fetch("https://api.badges.ninja/awards", {
method: "POST",
headers: { "X-Api-Key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
badgeId: "your-badge-id",
recipient: { name: "Jane Smith", email: "jane@example.com" },
issuedOn,
expires: issuedOn + twoYears,
}),
});
const { awardId } = await res.json(); // 200 OK
const verifyUrl = `https://badges.ninja/awards/${awardId}`;
以 Python 實作的同一個呼叫:
import time, requests
issued = int(time.time() * 1000)
two_years = 2 * 365 * 24 * 60 * 60 * 1000
res = requests.post(
"https://api.badges.ninja/awards",
headers={"X-Api-Key": API_KEY},
json={
"badgeId": "your-badge-id",
"recipient": {"name": "Jane Smith", "email": "jane@example.com"},
"issuedOn": issued,
"expires": issued + two_years,
},
)
award_id = res.json()["awardId"] # 200 OK
接收者姓名至少需要五個字元,issuedOn 為必填,呼叫成功會回傳 HTTP 200 以及 { awardId }。驗證 URL 不在回應中;你需要像上面所示那樣根據 id 自行組合。完整的請求規格請見簽發紀錄 API 參考文件。
在後台,平台會將你傳送的內容正規化為 ISO 8601 字串,並以 expires 的形式儲存在 Open Badges 斷言中。
驗證者會看到什麼
這是最重要的部分,因為沒人檢查的到期日期只是裝飾。
每個簽發紀錄都有一個公開的驗證頁面 https://badges.ninja/awards/<awardId>,檢視無需註冊。每次載入時,頁面都會將到期日期與當天日期比較:
- 到期日期之前: 頁面顯示憑證有效,並顯示一行帶日期的 “valid until”。
- 到期日期之後: 頁面切換為帶日期的 “Expired on” 提示。憑證仍然存在,因此歷史紀錄完整,但沒有人會把它誤認為是目前有效的憑證。
- 如果憑證已被撤銷: 撤銷的優先順序高於到期。已撤銷的憑證顯示為已撤銷,而不是僅僅顯示為已到期。
機器驗證者可以從 https://api.badges.ninja/certify-badge/award/<awardId> 的 Open Badge v2.0 JSON-LD 文件取得相同的資訊,斷言中帶有 expires 欄位。任何讀取該標準的工具都可以套用自己的政策。人資系統可能會直接拒絕已到期的憑證,而校友名錄則可能將其顯示為「曾獲認證」。
憑證還會把這個日期帶到外部。簽發紀錄上的 “Add to LinkedIn” 按鈕會在 LinkedIn 的認證項目中填入到期的月份和年份,因此此人的個人檔案會反映出你設定的同一個失效日期。可下載的 PDF 證書也會在簽發日期旁邊印出 “Expires” 日期。
有一個後果值得明確說明:到期是在有人查看的那一刻判定的,而不是由你這邊執行的某個排程工作來處理。憑證失效當天你不需要做任何事。沒有什麼東西會被「關閉」;驗證頁面只是如實反映日期。
查看即將失效的憑證
追蹤續期的專案需要一份即將到期人員的名單。控制台中的簽發紀錄頁面有一個 Expires 欄,顯示每個憑證的日期,打開某個憑證還會顯示一個橫幅:Active、Expires on 某個日期,或 Expired on 某個日期。

對於續期活動,最簡單的做法是選取你關心的列,然後使用 Export CSV。匯出的檔案包含一欄 “Valid To”。在試算表中開啟它,依該欄排序,大約一分鐘就能得到下一季的續期名單。
需要坦率說明一個限制:平台目前不會自動向接收者發送「你的憑證即將到期」的電子郵件。請把提醒當作你自己流程中的一個步驟。常見做法是在每月 1 號設一個行事曆提醒:匯出 CSV,篩選出未來 60 到 90 天內到期的日期,然後用你平時的郵件工具向這些人寄送續期說明。對於擁有幾百個憑證的大多數專案來說,這每月只需十分鐘,比建置通知系統省事得多。
如果你確實想自動化,簽發紀錄清單端點(GET /awards)每頁回傳 50 個憑證,每筆紀錄都包含其到期時間。寫一個排程腳本,走訪清單並寄信給 60 天內到期的人,只是個小專案。不過請先試試試算表,只有當手動步驟真正讓你頭痛時再去自動化。
續期模式
有人續期時,憑證應該怎麼處理?有三種合理的模式,具體選哪種取決於你的認證專案是如何定義的。
模式 1:簽發新的憑證(建議)
這是最清晰的做法。當事人完成複訓或重新認證考試後,你根據同一枚徽章簽發一個新的簽發紀錄,帶有新的簽發日期和新的到期日期。這樣他們就持有兩份使用同一枚徽章的憑證:舊的顯示為已到期,新的顯示為有效。
為什麼這通常是正確的做法:
- 每份憑證都如實記錄歷史:何時簽發,有效期至何時。
- 舊的公開 URL 仍然有效,並繼續顯示「已到期」,這是準確的。收藏過它的人不會被誤導。
- 新的簽發紀錄有自己的驗證 URL、PDF 證書和 Add to LinkedIn 項目。當事人可以取代舊的 LinkedIn 項目,也可以兩者都保留以顯示持續認證。
- 你的報表只需統計每位接收者在某枚徽章下的簽發數量,就能統計續期次數。
要保留新舊之間的關聯,可以把它寫進徽章標準或你自己的紀錄裡。重新認證徽章可以寫明「年度安全訓練的續期,完成複訓後有效。」如果你需要在自己的系統中建立硬關聯,請在簽發新憑證時,將新舊 awardId 一起存入你的學習管理系統或人資資料庫。
模式 2:原地編輯到期時間(僅限寄出之前)
平台支援原地編輯憑證,但僅限於尚未透過電子郵件寄出且尚未被撤銷的情況。在這個時間窗內,你可以修改接收者姓名、電子郵件、簽發日期或到期日期,而無需改變該簽發紀錄的 URL。這用於更正錯誤,例如設定時輸入了錯誤的到期日期,而不是用來延長某人已經持有的憑證。
憑證一旦透過電子郵件寄給接收者,就會被鎖定。如果之後需要變更,受支援的做法是撤銷它並簽發一個新的。這就引出了第三種模式。
模式 3:撤銷並重新簽發
當憑證完全不應再被視為有效時使用,例如當事人在有效期內遺失了執照,或者你簽發時選錯了徽章。這不是常規的續期途徑,因為撤銷傳達的訊號比到期更強烈:它表示這份憑證本不該被信任,而不僅僅是其期限已結束。我們關於撤銷 Open Badge 的逐步指南說明了兩者各自適用的情境。
一條很好的經驗法則:到期意味著期限結束;撤銷意味著出了問題。 不要僅僅因為憑證失效就撤銷它。讓它到期,並保留紀錄。
選擇有效期
到期日期是一項政策決策,訂錯了會帶來實實在在的麻煩。以下是我們見過運作良好的專案所採用的一些指引:
| 憑證類型 | 典型有效期 | 備註 |
|---|---|---|
| 資安或 IT 認證 | 2 至 3 年 | 工具和威脅變化很快 |
| 年度安全訓練 | 12 個月 | 通常與法規要求掛鉤 |
| 急救與 CPR | 2 年 | 遵循主管機關的規定,而不是慣例 |
| 繼續教育學分 | 報告週期結束 | 與週期對齊,使續期可以集中處理 |
| 課程結業 | 無到期時間 | 結業是一個事實;不要設定 expires |
兩個實用建議。第一,盡可能將到期日期與行事曆節奏對齊。如果一個班級的所有人都在同一天失效,續期就變成一次活動,而不是五十次。第二,不要給本質上只是完成紀錄的憑證設定到期時間。寫著「參加了 2025 年大會」的徽章不會因為明年而變得不那麼真實,給它設定到期日期只會造成困惑。
實戰範例:兩年有效的資安認證
下面以一個為 400 名員工的公司營運資安意識認證的訓練團隊為例,把以上內容串起來。
- 一次性設計好徽章,使用視覺化設計器。為它命名,設定標準(考試得分 80% 或以上方可通過),並在描述中說明有效期,讓接收者知道自己要承擔什麼。
- 帶到期時間簽發。 每次考試結束後,透過批次簽發上傳通過名單,並把到期時間設為兩年後。每個人都會收到一封郵件,包含驗證連結、PDF 證書和 Add to LinkedIn 按鈕。
- 每月檢查。 每月 1 號,匯出簽發紀錄清單,依 “Valid To” 排序,挑出未來 90 天內到期的所有人。
- 邀請他們續期。 用你平時的郵件工具向這些人寄送重新認證考試的連結。
- 簽發續期憑證。 有人通過後,根據同一枚徽章簽發新的簽發紀錄,設定新的兩年到期時間。舊的會自動顯示為已到期;無需對它做任何操作。
- 用一個連結回覆稽核人員。 當法遵部門詢問某人目前是否持證時,你只需傳送驗證 URL。它會顯示目前狀態,無需你查任何東西。
無需客製軟體,無需 cron 排程,無需遷移。這正是重點:生命週期管理主要就是選擇合理的日期,並養成每月檢查的習慣。
常見錯誤
- 給所有憑證都設定到期時間。 只對意義確實會隨時間減弱的憑證使用。否則你只是製造了沒有效益的續期工作。
- 混淆到期與撤銷。 撤銷已失效的憑證會破壞持續認證的歷史,讓此人看起來從未有效過。
- 忘記時區。 你選擇的日期會變成一個時間點。如果法規規定「有效期至三月底」,請依據你的政策解讀,將到期時間設為三月的最後一天或四月的第一天,並保持一致。
- 打算編輯而不是重新簽發。 編輯僅在憑證透過電子郵件寄出之前可用。從一開始就把續期規劃為新的簽發紀錄。
- 沒有提醒流程。 由於到期通知不是自動發送的,這個習慣必須由你來養成。把每月匯出放進某個人的行事曆裡。
下一步
如果你的憑證將被其他系統檢查,值得了解一下承載 expires 的文件結構:Open Badge JSON-LD 範例詳解逐一講解了斷言的每個欄位。而如果你正在權衡是否要繼續為這一切按憑證向平台付費,我們的 Credly 替代方案比較列出了各項成本。
準備好簽發你的第一份可驗證憑證了嗎? 在 badges.ninja 免費開始 — 視覺化設計器、公開驗證頁面、PDF 證書、Open Badge v2.0 輸出。無需信用卡。
本文章是如何完成的
本部落格的部分文章是在 AI 助理協助下起草,並在發布前由 Badges Ninja 團隊審閱、查證與編輯。所有程式碼範例與價格皆已對照正式產品驗證。如需了解我們的編輯與 AI 流程,請參閱我們的 編輯流程頁面 .

關於作者
Nacho Coll
Founder & Engineer at Badges Ninja
Nacho founded Badges Ninja to make issuing verifiable digital credentials as simple as a single API call — Open Badge v2.0 badges and certificates, minted, hosted, and verifiable without standing up your own issuer infrastructure. Writes about the Open Badges spec, credential verification, and running a credentialing platform serverless on AWS, from the operator side of the wire.


