Hết hạn và gia hạn Open Badge: Quản lý vòng đời cho chứng chỉ có thời hạn

Tín chỉ CE, chứng nhận và giấy phép đều có ngày hết hạn. Đặt expirationDate cho Open Badges và gia hạn bằng lập trình. Schema + quy trình.

Nacho Coll Bởi Cập nhật 14 phút đọc
Tín chỉ CE, chứng nhận và giấy phép đều có ngày hết hạn. Đặt expirationDate cho Open Badges và gia hạn bằng lập trình. Schema + quy trình.

Một số chứng chỉ có giá trị suốt đời. Bằng đại học không trở nên sai sự thật chỉ vì mười năm đã trôi qua. Nhưng phần lớn chứng chỉ mà các nhóm đào tạo cấp lại thuộc loại ngược lại: chứng nhận an ninh mạng hai năm, khóa bồi dưỡng an toàn xe nâng hằng năm, thẻ CPR, hay tín chỉ giáo dục thường xuyên chỉ có giá trị trong một chu kỳ báo cáo. Những chứng chỉ này là lời khẳng định rằng ai đó đủ năng lực tính đến một ngày nhất định, và lời khẳng định ấy có hạn sử dụng.

Nếu chứng chỉ số của bạn không bao giờ hết hạn, bạn đang âm thầm nói với nhà tuyển dụng và kiểm toán viên một điều không đúng sự thật. Bài viết này trình bày cách thời hạn hoạt động trong Open Badges, người xác minh thấy gì khi chứng chỉ hết hạn, và một quy trình gia hạn thực tế mà bạn không cần viết mã trừ khi bạn muốn.

Một lưu ý về tên gọi trước khi bắt đầu

Bạn sẽ thấy mọi người tìm kiếm “expirationDate”. Trong đặc tả Open Badges v2.0, trường trên một assertion (chính lần cấp, khác với badge class) có tên là expires. Đó là chuỗi date-time theo ISO 8601. Trường API bạn gửi khi cấp chứng chỉ trên https://badges.ninja cũng tên là expires. Cùng một ý tưởng nhưng tên gọi khác với điều đa số người đoán, nên hãy nhớ điều này khi đọc tài liệu JSON-LD hoặc tìm trong docs.

Hai điều đáng biết:

  • Thời hạn gắn với award, không gắn với badge. Cùng một badge (ví dụ “Annual Safety Training”) có thể được cấp cho một người với hạn vào tháng Ba và cho người khác với hạn vào tháng Chín. Đó chính là điều bạn muốn, vì hiệu lực được tính từ lúc mỗi người hoàn thành khóa đào tạo.
  • Nó là tùy chọn. Bỏ trống thì chứng chỉ không bao giờ hết hạn.

Đặt thời hạn khi cấp chứng chỉ

Bạn có ba cách để đặt thời gian hiệu lực. Hãy bắt đầu với hai cách đầu, vì chúng không cần mã.

Biểu mẫu trên dashboard. Khi tạo chứng chỉ, biểu mẫu có trường ngày “Expires” tùy chọn bên cạnh tên và email người nhận. Chọn ngày rồi cấp. Chỉ vậy thôi.

New Award form

Cấp hàng loạt. Nếu bạn cấp cho cả một khóa, trang cấp hàng loạt nhận một file CSV người nhận và áp dụng một ngày hết hạn duy nhất cho cả lô, để lớp hoàn thành trong cùng một tuần có cùng ngày hết hạn. Bạn có thể tạm dừng và tiếp tục một lô lớn. Hướng dẫn của chúng tôi về cấp Open Badges từ CSV trình bày định dạng file.

API. Để tự động hóa, chẳng hạn một hook của hệ thống quản lý học tập cấp chứng chỉ khi ai đó vượt qua kỳ thi, hãy thêm expires vào body của POST /awards. Trường này nhận cùng định dạng với issuedOn: mili giây epoch hoặc chuỗi ngày 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}`;

Cùng lời gọi đó bằng 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

Tên người nhận phải có ít nhất năm ký tự, issuedOn là bắt buộc, và lời gọi thành công trả về HTTP 200 cùng { awardId }. URL xác minh không nằm trong phản hồi; bạn tự dựng nó từ id như minh họa ở trên. Hợp đồng request đầy đủ nằm trong tài liệu tham chiếu awards API.

Ở phía sau, nền tảng chuẩn hóa mọi giá trị bạn gửi thành chuỗi ISO 8601 và lưu vào assertion Open Badges dưới dạng expires.

Người xác minh thấy gì

Đây là phần quan trọng nhất, vì một ngày hết hạn mà không ai kiểm tra chỉ là đồ trang trí.

Mỗi award có một trang xác minh công khai tại https://badges.ninja/awards/<awardId>, và không cần đăng ký để xem. Trang so sánh ngày hết hạn với ngày hôm nay mỗi lần tải:

  • Trước ngày hết hạn: trang hiển thị chứng chỉ là hợp lệ và có dòng “valid until” kèm ngày.
  • Sau ngày hết hạn: trang chuyển sang thông báo “Expired on” kèm ngày. Chứng chỉ vẫn còn đó nên lịch sử được giữ nguyên, nhưng không ai có thể nhầm nó với chứng chỉ còn hiệu lực.
  • Nếu chứng chỉ đã bị thu hồi: thu hồi được ưu tiên hơn hết hạn. Chứng chỉ bị thu hồi hiển thị là đã thu hồi (revoked), không chỉ là hết hạn.

Các trình xác minh máy nhận cùng thông tin từ tài liệu JSON-LD Open Badge v2.0 tại https://api.badges.ninja/certify-badge/award/<awardId>, nơi assertion mang trường expires. Bất kỳ công cụ nào đọc chuẩn này đều có thể áp dụng chính sách riêng. Một hệ thống nhân sự có thể từ chối thẳng chứng chỉ hết hạn, trong khi một danh bạ cựu học viên có thể hiển thị nó là “formerly certified”.

Chứng chỉ cũng mang ngày này ra bên ngoài. Nút “Add to LinkedIn” trên award tự điền tháng và năm hết hạn vào mục chứng nhận trên LinkedIn, nên hồ sơ của người đó phản ánh đúng ngày hết hạn bạn đã đặt. Chứng chỉ PDF tải về cũng in ngày “Expires” cạnh ngày cấp.

Một hệ quả cần nói thẳng: hết hạn được đánh giá vào lúc ai đó xem, chứ không phải bởi một tác vụ chạy phía bạn. Bạn không phải làm gì vào ngày chứng chỉ hết hạn. Không có gì bị “tắt đi”; trang xác minh chỉ đơn giản nói đúng sự thật về ngày tháng.

Xem điều gì sắp hết hạn

Các chương trình theo dõi gia hạn cần một danh sách những người sắp đến hạn. Trang awards trong dashboard có cột Expires hiển thị ngày của từng chứng chỉ, và mở một chứng chỉ sẽ thấy một banner: Active, Expires on a date, hoặc Expired on a date.

Awards list

Với một chiến dịch gia hạn, cách dễ nhất là chọn các dòng bạn quan tâm rồi dùng Export CSV. Bản xuất có cột “Valid To”. Mở nó trong bảng tính, sắp xếp theo cột đó, và trong khoảng một phút bạn có ngay quy trình gia hạn cho quý tới.

Chúng tôi cần nói thật về một giới hạn: hiện nền tảng không tự động gửi email “chứng chỉ của bạn sắp hết hạn” đến người nhận. Hãy coi việc nhắc nhở là một bước trong quy trình của riêng bạn. Một mô hình phổ biến là đặt lịch vào ngày đầu mỗi tháng: xuất CSV, lọc các ngày trong 60 đến 90 ngày tới, rồi gửi hướng dẫn gia hạn cho những người đó từ công cụ email thông thường. Với đa số chương trình có vài trăm chứng chỉ, việc này mất mười phút mỗi tháng và nhẹ nhàng hơn nhiều so với xây dựng một hệ thống thông báo.

Nếu bạn muốn tự động hóa, endpoint danh sách awards (GET /awards) trả về chứng chỉ của bạn theo trang 50 mục, và mỗi bản ghi đều có ngày hết hạn. Một script theo lịch duyệt qua danh sách và gửi email cho bất kỳ ai hết hạn trong 60 ngày là một dự án nhỏ. Nhưng hãy thử bảng tính trước và chỉ tự động hóa khi bước thủ công thực sự gây khó chịu.

Các mô hình gia hạn

Khi ai đó gia hạn, chứng chỉ nên được xử lý ra sao? Có ba mô hình hợp lý, và mô hình đúng phụ thuộc vào cách chương trình chứng nhận của bạn được định nghĩa.

Mô hình 1: Cấp một award mới (khuyến nghị)

Đây là cách gọn gàng nhất. Người đó hoàn thành khóa bồi dưỡng hoặc kỳ thi tái chứng nhận, và bạn cấp một award mới từ cùng badge với ngày cấp mới và ngày hết hạn mới. Giờ họ giữ hai chứng chỉ cùng một badge: cái cũ hiển thị là hết hạn, cái mới hiển thị là còn hiệu lực.

Vì sao cách này thường đúng:

  • Mỗi chứng chỉ ghi lại một lịch sử trung thực: cấp vào ngày này, có hiệu lực đến ngày kia.
  • URL công khai cũ vẫn hoạt động và vẫn hiển thị “expired”, đúng với thực tế. Không ai đã lưu đánh dấu nó bị hiểu nhầm.
  • Award mới có URL xác minh, chứng chỉ PDF và mục Add to LinkedIn riêng. Người đó có thể thay mục LinkedIn cũ hoặc giữ cả hai để thể hiện chứng nhận liên tục.
  • Báo cáo của bạn có thể đếm số lần gia hạn đơn giản bằng cách đếm số award theo từng người nhận cho một badge.

Để giữ liên kết giữa cái cũ và cái mới, hãy ghi nó vào tiêu chí của badge hoặc hồ sơ riêng của bạn. Một badge tái chứng nhận có thể ghi “Gia hạn của Annual Safety Training, có hiệu lực sau khi hoàn thành khóa bồi dưỡng.” Nếu cần liên kết chắc chắn trong hệ thống của bạn, hãy lưu cặp giá trị awardId cũ và mới cùng nhau trong cơ sở dữ liệu quản lý học tập hoặc nhân sự khi bạn cấp cái mới.

Mô hình 2: Sửa thời hạn tại chỗ (chỉ trước khi gửi)

Nền tảng hỗ trợ chỉnh sửa chứng chỉ tại chỗ, nhưng chỉ khi nó chưa được gửi email và chưa bị thu hồi. Trong khoảng đó bạn có thể sửa tên người nhận, email, ngày cấp hoặc ngày hết hạn mà không đổi URL của award. Cách này dùng để sửa lỗi, chẳng hạn ngày hết hạn gõ sai khi thiết lập, chứ không phải để kéo dài chứng chỉ mà ai đó đã nắm giữ.

Khi chứng chỉ đã được gửi email cho người nhận, nó bị khóa. Nếu cần thay đổi sau đó, cách được hỗ trợ là thu hồi nó và cấp cái mới. Điều đó đưa chúng ta đến mô hình thứ ba.

Mô hình 3: Thu hồi và cấp lại

Dùng cách này khi chứng chỉ hoàn toàn không còn được coi là hợp lệ, chẳng hạn người đó mất giấy phép giữa kỳ, hoặc bạn đã cấp nhầm badge. Đây không phải đường gia hạn thông thường, vì thu hồi gửi tín hiệu mạnh hơn hết hạn: nó nói rằng chứng chỉ lẽ ra không đáng tin, chứ không chỉ là thời hạn đã kết thúc. Hướng dẫn từng bước của chúng tôi về thu hồi một Open Badge nêu khi nào nên dùng cách nào.

Một nguyên tắc tốt: hết hạn nghĩa là thời hạn đã kết thúc; thu hồi nghĩa là có điều gì sai. Đừng thu hồi chứng chỉ chỉ vì chúng đã hết hạn. Hãy để chúng hết hạn và giữ lại hồ sơ.

Chọn thời gian hiệu lực

Ngày hết hạn là quyết định chính sách, và đặt sai sẽ gây rắc rối thật sự. Vài gợi ý từ các chương trình chúng tôi thấy vận hành tốt:

Loại chứng chỉHiệu lực thường gặpGhi chú
Chứng nhận an ninh mạng hoặc CNTT2 đến 3 nămCông cụ và mối đe dọa thay đổi nhanh
Đào tạo an toàn hằng năm12 thángThường gắn với yêu cầu pháp lý
Sơ cứu và CPR2 nămTheo quy định của cơ quan quản lý, không theo thông lệ
Tín chỉ giáo dục thường xuyênCuối chu kỳ báo cáoCăn theo chu kỳ để các lần gia hạn gộp thành một đợt
Hoàn thành khóa họcKhông hết hạnHoàn thành là một sự thật; bỏ trống expires

Hai mẹo thực tế. Thứ nhất, hãy căn ngày hết hạn theo nhịp lịch khi có thể. Nếu cả một khóa cùng hết hạn vào một ngày, gia hạn trở thành một chiến dịch thay vì năm mươi. Thứ hai, đừng đặt thời hạn cho những chứng chỉ thực chất là hồ sơ hoàn thành. Một badge ghi “đã tham dự hội nghị 2025” không bớt đúng đi vào năm sau, và ngày hết hạn trên nó chỉ gây nhầm lẫn.

Ví dụ thực tế: chứng nhận bảo mật hai năm

Hãy ghép tất cả lại cho một nhóm đào tạo chạy chứng nhận nhận thức về bảo mật cho một công ty 400 nhân viên.

  1. Thiết kế badge một lần trong trình thiết kế trực quan. Đặt tên, thiết lập tiêu chí (vượt qua kỳ thi với điểm từ 80 phần trăm trở lên), và mô tả thời gian hiệu lực trong phần mô tả để người nhận biết mình đang đăng ký điều gì.
  2. Cấp kèm thời hạn. Sau mỗi buổi thi, tải danh sách người đạt lên qua cấp hàng loạt với thời hạn đặt hai năm sau. Mỗi người nhận email gồm liên kết xác minh, chứng chỉ PDF và nút Add to LinkedIn.
  3. Kiểm tra hằng tháng. Vào ngày đầu tháng, xuất danh sách awards, sắp xếp theo “Valid To”, và lấy ra mọi người hết hạn trong 90 ngày tới.
  4. Mời họ gia hạn. Gửi cho họ liên kết kỳ thi tái chứng nhận từ công cụ email thông thường của bạn.
  5. Cấp bản gia hạn. Khi ai đó đạt, cấp một award mới từ cùng badge với thời hạn hai năm mới. Cái cũ tự hiển thị là hết hạn; đừng làm gì với nó.
  6. Trả lời kiểm toán viên bằng một liên kết. Khi bộ phận tuân thủ hỏi một người hiện có đang được chứng nhận không, bạn gửi URL xác minh. Nó hiển thị trạng thái hiện tại mà bạn không phải kiểm tra gì.

Không cần phần mềm tùy chỉnh, không cron job, không di chuyển dữ liệu. Đó chính là điểm mấu chốt: quản lý vòng đời phần lớn là chọn những ngày hợp lý và có một thói quen hằng tháng.

Những lỗi thường gặp

  • Đặt thời hạn cho mọi thứ. Hãy dành nó cho những chứng chỉ mà ý nghĩa của chúng thực sự phai nhạt. Nếu không, bạn tạo ra việc gia hạn mà chẳng được lợi gì.
  • Nhầm lẫn hết hạn với thu hồi. Thu hồi các chứng chỉ đã hết hạn sẽ phá hủy lịch sử chứng nhận liên tục và khiến người đó trông như chưa từng hợp lệ.
  • Quên múi giờ. Ngày bạn chọn trở thành một thời điểm cụ thể. Nếu quy định nói “có hiệu lực đến hết tháng Ba”, hãy đặt hạn là ngày cuối tháng Ba, hoặc ngày đầu tháng Tư, tùy cách chính sách của bạn diễn đạt, và hãy nhất quán.
  • Định sửa thay vì cấp lại. Chỉnh sửa chỉ khả dụng trước khi chứng chỉ được gửi email. Hãy lên kế hoạch gia hạn bằng các award mới ngay từ đầu.
  • Không có quy trình nhắc nhở. Vì thông báo hết hạn không tự động, thói quen phải đến từ bạn. Hãy đưa việc xuất dữ liệu hằng tháng vào lịch của ai đó.

Đi tiếp đến đâu

Nếu chứng chỉ của bạn sẽ được các hệ thống khác kiểm tra, bạn nên đọc cách cấu trúc của tài liệu mang expires: Hướng dẫn ví dụ JSON-LD của Open Badge đi qua từng trường của một assertion. Và nếu bạn đang cân nhắc có nên tiếp tục trả phí cho một nền tảng theo từng chứng chỉ cho tất cả những việc này, so sánh các lựa chọn thay thế Credly của chúng tôi trình bày chi phí.

Sẵn sàng cấp chứng chỉ có thể xác minh đầu tiên của bạn? Bắt đầu miễn phí tại badges.ninja — trình thiết kế trực quan, trang xác minh công khai, chứng chỉ PDF, đầu ra Open Badge v2.0. Không cần thẻ tín dụng.

Nacho Coll

Về tác giả

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.

Quay lại Blog

Bài viết liên quan