Expiration at Renewal ng Open Badge: Lifecycle Management para sa mga Credentials na may Takdang Panahon
Nag-e-expire ang CE credits, certifications, at licenses. Mag-set ng expirationDate sa Open Badges at i-renew ang mga ito nang programmatically. Schema + workflow.
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.
May mga credentials na panghabambuhay. Hindi nagiging hindi totoo ang isang degree dahil lang sampung taon na ang lumipas. Pero malaking bahagi ng mga credentials na ini-issue ng training teams ay kabaligtaran nito: dalawang taong cybersecurity certification, taunang forklift-safety refresher, CPR card, continuing-education credit na valid lang para sa isang reporting cycle. Ang mga credentials na ito ay pahayag na competent ang isang tao as of a certain date, at may shelf life ang pahayag na iyon.
Kung hindi kailanman nag-e-expire ang mga digital credentials mo, tahimik mong sinasabi sa mga employer at auditor ang bagay na hindi totoo. Tatalakayin ng artikulong ito kung paano gumagana ang expiration sa Open Badges, kung ano ang nakikita ng verifier kapag nag-lapse ang isang credential, at isang praktikal na renewal workflow na hindi mo kailangang mag-code maliban kung gusto mo.
Isang paalala tungkol sa pangalan bago tayo magsimula
Makikita mong “expirationDate” ang hinahanap ng maraming tao. Sa Open Badges v2.0 specification, ang field sa isang assertion (ang mismong award, kumpara sa badge class) ay tinatawag na expires. Isa itong ISO 8601 date-time string. Ang API field na ipinapadala mo kapag nag-i-issue ng credential sa https://badges.ninja ay expires din ang tawag. Parehong ideya, ibang pangalan sa inaakala ng karamihan, kaya tandaan ito kapag nagbabasa ka ng JSON-LD document o naghahanap sa docs.
Dalawang detalyeng dapat malaman:
- Nasa award ang expiration, hindi sa badge. Ang parehong badge (halimbawa, “Annual Safety Training”) ay puwedeng i-issue sa isang tao na may expiry sa Marso at sa iba naman na may expiry sa Setyembre. Iyon ang gusto mo, dahil binibilang ang validity mula nang matapos ng bawat tao ang training.
- Optional ito. Kapag hindi mo nilagay, hindi kailanman mag-e-expire ang credential.
Pag-set ng expiry kapag nag-i-issue
May tatlo kang paraan para mag-set ng validity period. Magsimula sa unang dalawa, dahil hindi nito kailangan ng code.
Ang dashboard form. Kapag gumagawa ka ng credential, may optional na “Expires” date field ang form sa tabi ng pangalan at email ng recipient. Pumili ng date at i-issue. Iyon na ang buong trabaho.

Bulk awards. Kung nag-i-issue ka sa buong cohort, tumatanggap ang bulk awards page ng CSV ng mga recipient at naglalapat ng iisang expiry date sa buong batch, kaya ang klase na natapos sa parehong linggo ay may parehong lapse date. Puwede mong i-pause at i-resume ang malaking batch. Saklaw ng walkthrough namin sa pag-issue ng Open Badges mula sa CSV ang format ng file.
Ang API. Para sa automation, tulad ng learning-management-system hook na nag-i-issue ng credential kapag pumasa ang isang tao sa exam, idagdag ang expires sa body ng POST /awards. Tumatanggap ito ng parehong mga format gaya ng issuedOn: epoch milliseconds o ISO date string.
// 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}`;
Ang parehong call sa 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
Dapat hindi bababa sa limang character ang pangalan ng recipient, kinakailangan ang issuedOn, at ang matagumpay na call ay nagbabalik ng HTTP 200 na may { awardId }. Wala sa response ang verification URL; binubuo mo ito mula sa id gaya ng ipinapakita. Nasa awards API reference ang buong request contract.
Sa likod ng eksena, nino-normalize ng platform ang anumang ipapadala mo bilang ISO 8601 string at sine-save ito sa Open Badges assertion bilang expires.
Ano ang nakikita ng verifier
Ito ang pinakamahalagang bahagi, dahil palamuti lang ang expiry date na walang nagche-check.
May public verification page ang bawat award sa https://badges.ninja/awards/<awardId>, at hindi kailangan ng signup para makita ito. Kinukumpara ng page ang expiry date sa petsa ngayon sa tuwing nilo-load ito:
- Bago ang expiry date: ipinapakita ng page ang credential bilang valid at may linyang “valid until” kasama ang petsa.
- Pagkatapos ng expiry date: nagiging “Expired on” notice ang page kasama ang petsa. Nandoon pa rin ang credential, kaya buo ang history, pero walang makakapagkamali na ito ay kasalukuyang valid.
- Kung na-revoke ang credential: nangingibabaw ang revocation sa expiry. Ang na-revoke na credential ay lumalabas bilang revoked, hindi lang basta expired.
Nakukuha ng machine verifiers ang parehong impormasyon mula sa Open Badge v2.0 JSON-LD document sa https://api.badges.ninja/certify-badge/award/<awardId>, kung saan dala ng assertion ang expires field. Kahit anong tool na bumabasa ng standard ay puwedeng maglapat ng sarili nitong policy. Puwedeng tahasang tanggihan ng HR system ang expired na credential, habang puwede itong ipakita ng alumni directory bilang “formerly certified”.
Dinadala rin ng credential ang petsa palabas. Pinupunan ng “Add to LinkedIn” button sa award ang expiration month at year sa LinkedIn certification entry, kaya ang profile ng tao ay sumasalamin sa parehong lapse date na itinakda mo. Naka-print din sa downloadable na PDF certificate ang “Expires” date sa tabi ng issue date.
Isang kahihinatnan na dapat sabihin nang tahasan: sinusuri ang expiry sa sandaling may tumitingin, hindi ng job na tumatakbo sa panig mo. Wala kang kailangang gawin sa araw na mag-lapse ang credential. Walang “pinapatay”; sinasabi lang ng verification page ang totoo tungkol sa petsa.
Pagtingin sa malapit nang mag-lapse
Ang mga programang nagta-track ng renewals ay nangangailangan ng listahan kung sino ang malapit nang mag-renew. May Expires column ang awards page sa dashboard na nagpapakita ng petsa ng bawat credential, at kapag binuksan ang isang credential, may banner: Active, Expires on isang petsa, o Expired on isang petsa.

Para sa renewal campaign, ang pinakamadaling ruta ay piliin ang mga row na kailangan mo at gamitin ang Export CSV. Kasama sa export ang “Valid To” column. Buksan ito sa spreadsheet, i-sort ayon sa column na iyon, at may renewal pipeline ka na para sa susunod na quarter sa loob ng halos isang minuto.
Dapat tayong maging tapat sa isang limitasyon: sa ngayon, hindi nagpapadala ang platform ng automated na “malapit nang mag-expire ang credential mo” emails sa mga recipient nang kusa. Ituring ang reminder bilang isang hakbang sa sarili mong proseso. Karaniwang pattern ang calendar entry sa unang araw ng bawat buwan: i-export ang CSV, i-filter ang mga petsa sa susunod na 60 hanggang 90 araw, at ipadala sa mga taong iyon ang renewal instructions mo gamit ang karaniwan mong email tool. Para sa karamihan ng programang may ilang daang credentials, sampung minuto lang ito kada buwan at mas kaunting trabaho kaysa gumawa ng notification system.
Kung gusto mo talagang i-automate, ibinabalik ng awards list endpoint (GET /awards) ang mga credentials mo sa mga page na may tig-50, at kasama sa bawat record ang expiry nito. Maliit na proyekto ang scheduled script na sumusuyod sa listahan at nag-e-email sa sinumang mag-e-expire sa loob ng 60 araw. Pero subukan muna ang spreadsheet at mag-automate lang kapag talagang masakit na ang manual na hakbang.
Mga renewal pattern
Kapag nag-renew ang isang tao, ano ang dapat mangyari sa credential? May tatlong makatwirang pattern, at ang tama ay depende sa kung paano tinukoy ang certification program mo.
Pattern 1: Mag-issue ng bagong award (inirerekomenda)
Ito ang pinakamalinis na paraan. Tinatapos ng tao ang refresher o ang recertification exam, at nag-i-issue ka ng bagong award mula sa parehong badge na may bagong issue date at bagong expiry date. Dalawa na ang hawak nilang credentials na may parehong badge: ang luma, na lumalabas bilang expired, at ang bago, na lumalabas bilang active.
Bakit ito kadalasang tama:
- Nagtatala ang bawat credential ng tapat na history: na-issue sa petsang ito, valid hanggang sa petsang iyon.
- Patuloy na gumagana ang lumang public URL at patuloy na nagsasabing “expired”, na tumpak. Walang naloloko sa nag-bookmark nito.
- May sariling verification URL, PDF certificate, at Add to LinkedIn entry ang bagong award. Puwedeng palitan ng tao ang lumang LinkedIn entry o panatilihin ang dalawa para ipakita ang tuloy-tuloy na certification.
- Mabibilang ng mga report mo ang renewals sa pamamagitan lang ng pagbilang ng awards kada recipient para sa isang badge.
Para mapanatili ang link ng luma at bago, ilagay ito sa badge criteria o sa sarili mong records. Puwedeng sabihin ng recertification badge na “Renewal of Annual Safety Training, valid after completing the refresher.” Kung kailangan mo ng hard link sa sarili mong system, i-store nang magkasama ang luma at bagong awardId sa learning-management o HR database mo kapag nag-issue ka ng bago.
Pattern 2: I-edit ang expiry in place (bago lang maipadala)
Sinusuportahan ng platform ang pag-edit ng credential in place, pero habang hindi pa ito naipapadala sa email at hindi pa na-revoke. Sa loob ng window na iyon, puwede mong ayusin ang pangalan ng recipient, email, issue date, o expiry date nang hindi nagbabago ang URL ng award. Para ito sa pagtatama ng mga pagkakamali, gaya ng maling expiry date na na-type habang nagse-setup, hindi para pahabain ang credential na hawak na ng tao.
Kapag naipadala na sa email ng recipient ang credential, naka-lock na ito. Kung kailangan mo itong baguhin pagkatapos noon, ang suportadong ruta ay i-revoke ito at mag-issue ng bago. Dinadala tayo nito sa ikatlong pattern.
Pattern 3: I-revoke at i-re-issue
Gamitin ito kapag hindi na dapat ituring na valid ang credential, halimbawa nawalan ng license ang tao sa kalagitnaan ng term, o na-issue mo ito gamit ang maling badge. Hindi ito ang normal na renewal path, dahil mas malakas na senyales ang revocation kaysa expiry: sinasabi nitong hindi dapat pinagkatiwalaan ang credential, hindi lang natapos ang term nito. Saklaw ng step-by-step namin sa pag-revoke ng Open Badge kung kailan angkop ang bawat isa.
Magandang rule of thumb: ang expiry ay nangangahulugang natapos ang term; ang revocation ay nangangahulugang may mali. Huwag mag-revoke ng credentials dahil lang nag-lapse na ang mga ito. Hayaang mag-expire at panatilihin ang record.
Pagpili ng validity period
Mga desisyon sa policy ang expiry dates, at ang pagkakamali dito ay nagdudulot ng totoong sakit ng ulo. Ilang gabay mula sa mga programang nakikita naming gumagana nang maayos:
| Uri ng credential | Karaniwang validity | Mga tala |
|---|---|---|
| Cybersecurity o IT certification | 2 hanggang 3 taon | Mabilis magbago ang mga tool at banta |
| Taunang safety training | 12 buwan | Madalas na nakatali sa regulatory requirement |
| First aid at CPR | 2 taon | Sundin ang patakaran ng regulator mo, hindi ang nakagawian |
| Continuing-education credit | Katapusan ng reporting cycle | I-align sa cycle para magsabay-sabay ang renewals |
| Pagtatapos ng kurso | Walang expiry | Katotohanan ang completion; huwag lagyan ng expires |
Dalawang praktikal na tip. Una, i-align ang expiry dates sa ritmo ng kalendaryo hangga’t maaari. Kung lahat ng nasa cohort ay nag-lapse sa parehong petsa, nagiging isang campaign ang renewal sa halip na limampu. Pangalawa, huwag maglagay ng expiry sa mga credentials na talagang record lang ng completion. Ang badge na nagsasabing “dumalo sa 2025 conference” ay hindi nagiging mas hindi totoo sa susunod na taon, at kalituhan lang ang dulot ng expiry date dito.
Isang worked example: dalawang taong security certification
Pagsama-samahin natin para sa training team na nagpapatakbo ng security-awareness certification para sa kumpanyang may 400 empleyado.
- Idisenyo ang badge nang isang beses sa visual designer. Pangalanan ito, itakda ang criteria (pumasa sa exam na may score na 80 percent o mas mataas), at ilarawan ang validity period sa description para alam ng mga recipient kung ano ang pinapasok nila.
- Mag-issue na may expiry. Pagkatapos ng bawat exam session, i-upload ang pass list sa pamamagitan ng bulk awards na may expiry na dalawang taon mula ngayon. Natatanggap ng bawat tao ang email nila na may verification link, PDF certificate, at Add to LinkedIn button.
- Mag-check buwan-buwan. Sa unang araw ng buwan, i-export ang awards list, i-sort ayon sa “Valid To”, at kunin ang lahat ng mag-e-expire sa susunod na 90 araw.
- Imbitahin silang mag-renew. Ipadala sa kanila ang recertification exam link gamit ang karaniwan mong email tool.
- I-issue ang renewal. Kapag may pumasa, mag-issue ng bagong award mula sa parehong badge na may bagong dalawang taong expiry. Kusang lalabas na expired ang luma; wala kang gagawin dito.
- Sagutin ang mga auditor gamit ang link. Kapag nagtanong ang compliance kung kasalukuyang certified ang isang tao, ipapadala mo ang verification URL. Ipinapakita nito ang kasalukuyang status nang hindi ka nagche-check ng kahit ano.
Walang custom software, walang cron jobs, walang migrations. Iyon ang punto: ang lifecycle management ay kadalasang usapin ng pagpili ng makatwirang petsa at pagkakaroon ng buwanang gawi.
Mga karaniwang pagkakamali
- Pag-set ng expiry sa lahat. Ireserba ito para sa mga credentials na ang kahulugan ay talagang kumukupas. Kung hindi, lumilikha ka ng renewal work na walang benepisyo.
- Pagkalito sa expiry at revocation. Sinisira ng pag-revoke sa mga lapsed na credentials ang history ng tuloy-tuloy na certification at pinapalabas na hindi kailanman valid ang tao.
- Pagkalimot sa timezone. Nagiging isang punto sa oras ang petsang pipiliin mo. Kung sinasabi ng regulasyon na “valid hanggang katapusan ng Marso”, i-set ang expiry sa huling araw ng Marso, o sa unang araw ng Abril, depende sa kung paano binabasa ang policy mo, at maging consistent.
- Pagpaplanong mag-edit sa halip na mag-re-issue. Available lang ang pag-edit bago maipadala sa email ang credential. Planuhin ang renewals bilang bagong awards mula sa simula.
- Walang reminder process. Dahil hindi automated ang expiry notices, ikaw ang dapat may gawi. Ilagay sa kalendaryo ng isang tao ang buwanang export.
Saan susunod
Kung susuriin ng ibang systems ang credentials mo, sulit basahin kung paano nakabuo ang document na may dalang expires: ang Open Badge JSON-LD example walkthrough ay dumadaan sa bawat field ng isang assertion. At kung tinitimbang mo kung patuloy kang magbabayad sa platform kada credential para sa lahat ng ito, inilalatag ng Credly alternative comparison namin ang mga gastos.
Handa ka na bang mag-issue ng una mong verifiable credential? Magsimula nang libre sa badges.ninja — visual designer, public verification page, PDF certificate, Open Badge v2.0 output. Hindi kailangan ng credit card.
Paano ginawa ang artikulong ito
Ang ilang artikulo sa blog na ito ay ginagawa gamit ang tulong ng AI assistant, pagkatapos ay sinusuri, tinitiyak ang katumpakan, at ine-edit ng Badges Ninja team bago ilathala. Bawat code sample at presyo ay beripikado laban sa live na produkto. Alamin pa ang tungkol sa aming editorial at AI na proseso sa aming pahina ng editorial process .

Tungkol sa may-akda
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.
Higit pa mula kay Nacho Coll
- Open Badges para sa Coding Bootcamp: Mag-issue ng Verifiable Credentials sa Laki ng Buong CohortNob 19, 2026 · 12min basahin
- Pag-set Up ng Webhooks para sa Badge Events: Real-Time na Integration sa Iyong BackendNob 16, 2026 · 10min basahin
- Open Badge Baking, Ipinaliwanag: Paano Nakatira ang JSON sa Loob ng PNGNob 9, 2026 · 12min basahin


