Open Badge'i aegumine ja uuendamine: ajaliselt piiratud kvalifikatsioonide elutsükli haldus
Täiendkoolituse punktid, sertifikaadid ja litsentsid aeguvad. Määra Open Badge'idele expirationDate ja uuenda neid programmiliselt. Skeem + töövoog.
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.
Mõned kvalifikatsioonid kehtivad eluks ajaks. Diplom ei lakka tõele vastamast selle pärast, et on möödunud kümme aastat. Suur osa koolitustiimide väljastatavatest kvalifikatsioonidest on aga vastupidised: kaheaastane küberturvalisuse sertifikaat, iga-aastane tõstukiohutuse kordusõpe, esmaabikaart, täiendkoolituse punkt, mis kehtib vaid ühe aruandlusperioodi. Need kvalifikatsioonid on väide, et keegi oli teatud kuupäeva seisuga pädev, ja sellel väitel on säilivusaeg.
Kui sinu digitaalsed kvalifikatsioonid ei aegu kunagi, ütled tööandjatele ja audiitoritele vaikides midagi, mis ei vasta tõele. See artikkel selgitab, kuidas aegumine Open Badge’ides töötab, mida kontrollija näeb, kui kvalifikatsioon aegub, ja praktilist uuendamise töövoogu, mille jaoks ei pea koodi kirjutama, kui sa just ei taha.
Üks nimetamismärkus enne alustamist
Inimesed otsivad „expirationDate”. Open Badges v2.0 spetsifikatsioonis nimetatakse assertioni (ehk väljaandmise enda, erinevalt märgi klassist) väli expires. See on ISO 8601 kuupäeva-kellaaja string. API väli, mille saadad kvalifikatsiooni väljaandmisel aadressil https://badges.ninja, on samuti expires. Idee on sama, nimi on aga teistsugune, kui enamik arvab, nii et pea seda meeles JSON-LD dokumenti lugedes või dokumentatsioonist otsides.
Kaks asja, mida tasub teada:
- Aegumine on seotud väljaandmisega, mitte märgiga. Sama märgi (näiteks „Annual Safety Training”) võib ühele inimesele välja anda märtsis aeguvana ja teisele septembris aeguvana. See ongi see, mida sa tahad, sest kehtivus loetakse sellest, millal iga inimene koolituse lõpetas.
- See on valikuline. Jäta ära ja kvalifikatsioon ei aegu kunagi.
Aegumise määramine väljaandmisel
Kehtivusaja saab seada kolmel viisil. Alusta esimese kahega, sest need ei vaja koodi.
Töölaua vorm. Kvalifikatsiooni loomisel on vormil saaja nime ja e-posti kõrval valikuline kuupäevaväli „Expires”. Vali kuupäev ja anna välja. See on kogu töö.

Hulgiväljaandmine. Kui annad välja tervele rühmale, võtab hulgiväljaandmise leht vastu saajate CSV ja rakendab kogu partiile ühe aegumiskuupäeva, nii et samal nädalal lõpetanud klass saab sama aegumiskuupäeva. Suurt partiid saab peatada ja jätkata. Meie juhend Open Badge’ide väljastamisest CSV-st kirjeldab failivormingut.
API. Automatiseerimiseks, näiteks õppehaldussüsteemi konks, mis väljastab kvalifikatsiooni, kui keegi eksami sooritab, lisa expires päringu POST /awards kehasse. See aktsepteerib samu vorminguid mis issuedOn: epohhi millisekundid või ISO kuupäevastring.
// 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}`;
Sama kutse Pythonis:
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
Saaja nimi peab olema vähemalt viie tähemärgi pikkune, issuedOn on kohustuslik ja eduka kutse tulemuseks on HTTP 200 koos { awardId }. Kontrolli URL-i vastuses ei ole; koostad selle id-st, nagu näidatud. Täielik päringu leping on awards API viites.
Platvorm normaliseerib kulisside taga kõik, mida saadad, ISO 8601 stringiks ja salvestab selle Open Badges assertionisse kui expires.
Mida kontrollija näeb
See on kõige olulisem osa, sest aegumiskuupäev, mida keegi ei kontrolli, on kaunistus.
Igal väljaandmisel on avalik kontrolli leht aadressil https://badges.ninja/awards/<awardId> ja vaatamiseks pole registreerumist vaja. Leht võrdleb aegumiskuupäeva tänase kuupäevaga iga kord, kui see laadib:
- Enne aegumiskuupäeva: leht näitab kvalifikatsiooni kehtivana ja kuvab rea „valid until” koos kuupäevaga.
- Pärast aegumiskuupäeva: leht lülitub teatele „Expired on” koos kuupäevaga. Kvalifikatsioon on endiselt olemas, nii et ajalugu jääb alles, kuid keegi ei saa seda praeguse kvalifikatsiooniga segi ajada.
- Kui kvalifikatsioon tühistati: tühistamine on aegumisest ülimuslik. Tühistatud kvalifikatsioon kuvatakse tühistatuna, mitte pelgalt aegununa.
Masinkontrollijad saavad sama teabe Open Badge v2.0 JSON-LD dokumendist aadressil https://api.badges.ninja/certify-badge/award/<awardId>, kus assertion kannab välja expires. Iga tööriist, mis standardit loeb, saab rakendada oma poliitikat. Personalisüsteem võib aegunud kvalifikatsiooni sootuks tagasi lükata, vilistlaste kataloog aga võib näidata seda kui „endine sertifitseeritu”.
Kvalifikatsioon kannab kuupäeva ka väljapoole. Väljaandmise nupp „Add to LinkedIn” täidab LinkedIni sertifikaadikirjes aegumise kuu ja aasta, nii et inimese profiil peegeldab sama aegumiskuupäeva, mille sina määrasid. Ka allalaaditav PDF-sertifikaat trükib väljaandmise kuupäeva kõrvale kuupäeva „Expires”.
Üks tagajärg, mida tasub otse öelda: aegumist hinnatakse hetkel, kui keegi vaatab, mitte sinu poolel jooksva tööga. Päeval, mil kvalifikatsioon aegub, ei pea sa midagi tegema. Midagi ei „lülitata välja”; kontrolli leht lihtsalt räägib kuupäeva kohta tõtt.
Mis hakkab peagi aeguma
Uuendamisi jälgivad programmid vajavad nimekirja neist, kelle kehtivus hakkab lõppema. Töölaua väljaandmiste lehel on veerg Expires, mis näitab iga kvalifikatsiooni kuupäeva, ja kvalifikatsiooni avamisel kuvatakse bänner: Active, Expires on kuupäev või Expired on kuupäev.

Uuendamiskampaania jaoks on lihtsaim tee valida sind huvitavad read ja kasutada Export CSV. Eksport sisaldab veergu „Valid To”. Ava see tabelarvutuses, sorteeri selle veeru järgi ja sul on umbes minutiga järgmise kvartali uuendamiste voog.
Üks piirang tuleb ausalt öelda: platvorm ei saada praegu saajatele ise automaatseid e-kirju „sinu kvalifikatsioon aegub peagi”. Käsitle meeldetuletust sammuna oma protsessis. Levinud muster on kalendrikanne iga kuu esimesele päevale: ekspordi CSV, filtreeri kuupäevad järgmise 60 kuni 90 päeva sees ja saada neile inimestele uuendamisjuhised oma tavalisest e-posti tööriistast. Enamiku mõnesaja kvalifikatsiooniga programmide puhul võtab see kümme minutit kuus ja on palju vähem tööd kui teavitussüsteemi ehitamine.
Kui tahad seda siiski automatiseerida, tagastab väljaandmiste nimekirja lõpp-punkt (GET /awards) sinu kvalifikatsioonid 50 kaupa lehtedena ja iga kirje sisaldab aegumiskuupäeva. Ajastatud skript, mis käib nimekirja läbi ja saadab e-kirja kõigile, kelle kehtivus lõpeb 60 päeva jooksul, on väike projekt. Proovi aga esmalt tabelarvutust ja automatiseeri alles siis, kui käsitsi samm tõesti valutab.
Uuendamise mustrid
Mis peaks kvalifikatsiooniga juhtuma, kui keegi uuendab? On kolm mõistlikku mustrit ja õige sõltub sellest, kuidas sinu sertifitseerimisprogramm on määratletud.
Muster 1: Anna välja uus väljaandmine (soovitatav)
See on kõige puhtam lähenemine. Inimene sooritab kordusõppe või ümbersertifitseerimise eksami ja sina annad samast märgist välja uue väljaandmise uue väljaandmiskuupäeva ja uue aegumiskuupäevaga. Nüüd on tal kaks sama märgiga kvalifikatsiooni: vana, mis kuvatakse aegununa, ja uus, mis kuvatakse aktiivsena.
Miks see on tavaliselt õige:
- Iga kvalifikatsioon salvestab ausa ajaloo: välja antud sellel kuupäeval, kehtib selle kuupäevani.
- Vana avalik URL töötab edasi ja ütleb edasi „expired”, mis on täpne. Keegi, kes selle järjehoidjasse pani, ei jää eksiteele.
- Uus väljaandmine saab oma kontrolli URL-i, PDF-sertifikaadi ja Add to LinkedIn kirje. Inimene võib vana LinkedIni kirje asendada või hoida mõlemad, et näidata pidevat sertifitseeritust.
- Sinu aruanded saavad uuendusi lugeda lihtsalt märgi väljaandmisi saaja kohta kokku lugedes.
Vana ja uue vahelise seose säilitamiseks kirjuta see märgi kriteeriumidesse või oma andmetesse. Ümbersertifitseerimise märk võib öelda „Annual Safety Training uuendus, kehtib pärast kordusõppe läbimist.” Kui vajad oma süsteemis kõva seost, salvesta vana ja uus awardId koos oma õppehaldus- või personaliandmebaasi, kui uue välja annad.
Muster 2: Muuda aegumist kohapeal (ainult enne saatmist)
Platvorm toetab kvalifikatsiooni kohapeal muutmist, kuid ainult seni, kuni seda pole e-postiga saadetud ja see pole tühistatud. Selles aknas saad parandada saaja nime, e-posti, väljaandmiskuupäeva või aegumiskuupäeva ilma väljaandmise URL-i muutmata. See on vigade parandamiseks, näiteks seadistamisel sisestatud vale aegumiskuupäev, mitte kvalifikatsiooni pikendamiseks, mis inimesel juba on.
Kui kvalifikatsioon on saajale e-postiga saadetud, on see lukus. Kui seda tuleb pärast seda muuta, on toetatud tee see tühistada ja anda välja uus. See toob meid kolmanda mustrini.
Muster 3: Tühista ja anna uuesti välja
Kasuta seda, kui kvalifikatsiooni ei tohiks enam üldse kehtivaks pidada, näiteks inimene kaotas litsentsi kehtivusaja keskel või andsid selle välja vale märgiga. See pole tavaline uuendamise tee, sest tühistamine annab tugevama signaali kui aegumine: see ütleb, et kvalifikatsiooni poleks tohtinud usaldada, mitte lihtsalt et selle tähtaeg sai läbi. Meie samm-sammuline juhend Open Badge’i tühistamisest selgitab, millal kumb sobib.
Hea rusikareegel: aegumine tähendab, et tähtaeg sai läbi; tühistamine tähendab, et midagi oli valesti. Ära tühista kvalifikatsioone ainult sellepärast, et need aegusid. Lase neil aeguda ja säilita kirje.
Kehtivusaja valimine
Aegumiskuupäevad on poliitikaotsused ja vigased tekitavad päris peavalu. Mõned juhised programmidest, mis meie hinnangul hästi töötavad:
| Kvalifikatsiooni tüüp | Tüüpiline kehtivus | Märkused |
|---|---|---|
| Küberturvalisuse või IT sertifikaat | 2 kuni 3 aastat | Tööriistad ja ohud muutuvad kiiresti |
| Iga-aastane ohutuskoolitus | 12 kuud | Sageli seotud regulatiivse nõudega |
| Esmaabi ja elustamine | 2 aastat | Järgi oma reguleerija reeglit, mitte tava |
| Täiendkoolituse punkt | Aruandlustsükli lõpp | Joonda tsükliga, et uuendused koonduksid |
| Kursuse läbimine | Aegumist pole | Läbimine on fakt; jäta expires ära |
Kaks praktilist nõuannet. Esiteks joonda aegumiskuupäevad võimaluse korral kalendrirütmiga. Kui kõigi rühma liikmete kehtivus lõpeb samal kuupäeval, on uuendamine üks kampaania viiekümne asemel. Teiseks ära pane aegumist kvalifikatsioonidele, mis on tegelikult läbimise kirjed. Märk, mis ütleb „osales 2025. aasta konverentsil”, ei muutu järgmisel aastal vähem tõeseks ja sellel olev aegumiskuupäev tekitab vaid segadust.
Läbitöötatud näide: kaheaastane turvasertifikaat
Kõik kokku 400 töötajaga ettevõtte turvateadlikkuse sertifikaati pakkuva koolitustiimi jaoks.
- Kujunda märk üks kord visuaalses kujundajas. Pane sellele nimi, määra kriteeriumid (eksam sooritatud tulemusega 80 protsenti või rohkem) ja kirjelda kirjelduses kehtivusaega, et saajad teaksid, milleks nad end kirja panevad.
- Anna välja aegumisega. Pärast iga eksamisessiooni lae edukate nimekiri üles hulgiväljaandmise kaudu, aegumine seatud kaks aastat ette. Igaüks saab oma e-kirja koos kontrolli lingi, PDF-sertifikaadi ja nupuga Add to LinkedIn.
- Kontrolli igakuiselt. Kuu esimesel päeval ekspordi väljaandmiste nimekiri, sorteeri „Valid To” järgi ja võta välja kõik, kelle kehtivus lõpeb järgmise 90 päeva jooksul.
- Kutsu neid uuendama. Saada neile inimestele ümbersertifitseerimise eksami link oma tavalisest e-posti tööriistast.
- Anna välja uuendus. Kui keegi sooritab, anna samast märgist välja uus väljaandmine uue kaheaastase aegumisega. Vana kuvatakse ise aegununa; ära tee sellega midagi.
- Vasta audiitoritele lingiga. Kui vastavuse osakond küsib, kas inimene on praegu sertifitseeritud, saadad kontrolli URL-i. See näitab praegust olekut ilma, et peaksid midagi kontrollima.
Ei mingit eritarkvara, ei cron-töid, ei migratsioone. Selles ongi point: elutsükli haldus on enamasti mõistlike kuupäevade valimine ja igakuine harjumus.
Levinud vead
- Aegumise seadmine kõigele. Jäta see kvalifikatsioonidele, mille tähendus tõesti hajub. Muidu tekitad uuendamistööd ilma kasuta.
- Aegumise segiajamine tühistamisega. Aegunud kvalifikatsioonide tühistamine hävitab pideva sertifitseerituse ajaloo ja paneb inimese tunduma, nagu poleks ta kunagi kehtiv olnud.
- Ajavööndi unustamine. Valitud kuupäevast saab ajahetk. Kui määrus ütleb „kehtib märtsi lõpuni”, määra aegumine märtsi viimaseks päevaks või aprilli esimeseks päevaks, sõltuvalt sellest, kuidas sinu poliitika loeb, ja ole järjepidev.
- Muutmise planeerimine uuesti väljaandmise asemel. Muutmine on võimalik ainult enne kvalifikatsiooni e-postiga saatmist. Planeeri uuendused algusest peale uute väljaandmistena.
- Meeldetuletusprotsessi puudumine. Kuna aegumisteateid ei automatiseerita, peab harjumus olema sinu oma. Pane igakuine eksport kellegi kalendrisse.
Kuhu edasi
Kui sinu kvalifikatsioone kontrollivad teised süsteemid, tasub lugeda, kuidas on üles ehitatud dokument, mis kannab välja expires: Open Badge JSON-LD example walkthrough käib läbi iga assertioni välja. Ja kui kaalud, kas jätkata platvormile iga kvalifikatsiooni eest maksmist, toob meie Credly alternatiivi võrdlus kulud välja.
Valmis oma esimest kontrollitavat kvalifikatsiooni välja andma? Alusta tasuta badges.ninjas — visuaalne kujundaja, avalik kontrolli leht, PDF-sertifikaat, Open Badge v2.0 väljund. Krediitkaarti pole vaja.
Kuidas see artikkel valmis
Osa selle blogi postitustest on koostatud tehisintellekti abiga ning seejärel üle vaadatud, faktikontrollitud ja toimetatud Badges Ninja meeskonna poolt enne avaldamist. Iga koodinäide ja hind on kontrollitud reaalse toote vastu. Loe lähemalt meie toimetus- ja AI-protsessi kohta meie toimetusprotsessi lehel .

Autorist
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.
Rohkem autorilt Nacho Coll
- Programmeerimiskooli Open Badges: kontrollitavate tunnistuste väljaandmine terve kohordi mastaabis19. nov 2026 · 9min lugemist
- Veebikonksude seadistamine märgisündmuste jaoks: reaalajas integratsioon sinu taustasüsteemiga16. nov 2026 · 7min lugemist
- Open Badge'i küpsetamine lahti seletatud: kuidas JSON PNG-s elab9. nov 2026 · 9min lugemist


