Potek veljavnosti in obnova Open Badges: upravljanje življenjskega cikla časovno omejenih poverilnic
Kreditne točke za stalno izobraževanje, certifikati in licence potečejo. Nastavite expirationDate na značkah Open Badges in jih obnavljajte programsko. Shema + potek dela.
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.
Nekatere poverilnice veljajo vse življenje. Diploma ne postane neresnična, ker je minilo deset let. Velik del poverilnic, ki jih izdajajo izobraževalne ekipe, pa je ravno nasproten: dveletni certifikat iz kibernetske varnosti, letno osvežitveno usposabljanje za viličarje, kartica za temeljne postopke oživljanja, kreditna točka stalnega izobraževanja, ki velja le za eno poročevalsko obdobje. Te poverilnice so izjava, da je bila oseba na določen datum usposobljena, in ta izjava ima rok trajanja.
Če vaše digitalne poverilnice nikoli ne potečejo, delodajalcem in revizorjem tiho sporočate nekaj, kar ni res. Ta članek pojasnjuje, kako potek veljavnosti deluje v Open Badges, kaj vidi preverjevalec, ko poverilnica poteče, in praktičen potek dela za obnovo, pri katerem vam ni treba pisati kode, če tega ne želite.
Ena opomba o poimenovanju, preden začnemo
Ljudje iščejo »expirationDate«. V specifikaciji Open Badges v2.0 se polje na trditvi (assertion, torej sami podelitvi, za razliko od razreda značke) imenuje expires. Gre za niz datuma in časa po ISO 8601. Polje API-ja, ki ga pošljete ob izdaji poverilnice na https://badges.ninja, se prav tako imenuje expires. Ideja je ista, ime pa drugačno, kot si večina misli, zato to upoštevajte pri branju dokumenta JSON-LD ali iskanju po dokumentaciji.
Dve podrobnosti, ki jih je vredno poznati:
- Potek veljavnosti je vezan na podelitev, ne na značko. Ista značka (recimo »Annual Safety Training«) se lahko eni osebi izda s potekom marca, drugi pa s potekom septembra. In prav to želite, saj se veljavnost šteje od trenutka, ko je posamezna oseba zaključila usposabljanje.
- Polje je neobvezno. Če ga izpustite, poverilnica nikoli ne poteče.
Nastavitev poteka ob izdaji
Obdobje veljavnosti lahko nastavite na tri načine. Začnite s prvima dvema, saj ne zahtevata kode.
Obrazec na nadzorni plošči. Ko ustvarjate poverilnico, ima obrazec poleg imena in e-pošte prejemnika neobvezno polje »Expires« z datumom. Izberite datum in izdajte. To je vse.

Množične podelitve. Če izdajate celotni skupini, stran za množične podelitve sprejme CSV s prejemniki in celotni seriji uporabi en datum poteka, tako da razred, ki je končal v istem tednu, dobi isti datum poteka. Veliko serijo lahko začasno ustavite in nadaljujete. Naš vodič o izdajanju Open Badges iz CSV opisuje obliko datoteke.
API. Za avtomatizacijo, na primer kaveljček v sistemu za upravljanje učenja, ki izda poverilnico, ko nekdo opravi izpit, dodajte expires v telo zahtevka POST /awards. Sprejema enake oblike kot issuedOn: milisekunde od epohe ali niz z datumom 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}`;
Isti klic v Pythonu:
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
Ime prejemnika mora imeti vsaj pet znakov, issuedOn je obvezen, uspešen klic pa vrne HTTP 200 z { awardId }. URL za preverjanje ni v odgovoru; sestavite ga iz id-ja, kot je prikazano. Celotna pogodba zahtevka je v referenci API-ja za podelitve.
V ozadju platforma vse, kar pošljete, normalizira v niz ISO 8601 in ga shrani v trditev Open Badges kot expires.
Kaj vidi preverjevalec
To je najpomembnejši del, saj je datum poteka, ki ga nihče ne preverja, zgolj okras.
Vsaka podelitev ima javno stran za preverjanje na https://badges.ninja/awards/<awardId>, za ogled pa ni potrebna prijava. Stran ob vsakem nalaganju primerja datum poteka z današnjim datumom:
- Pred datumom poteka: stran prikaže poverilnico kot veljavno in izpiše vrstico »valid until« z datumom.
- Po datumu poteka: stran preklopi na obvestilo »Expired on« z datumom. Poverilnica je še vedno tam, zato je zgodovina nedotaknjena, a je nihče ne more zamenjati za veljavno.
- Če je bila poverilnica preklicana: preklic ima prednost pred potekom. Preklicana poverilnica je prikazana kot preklicana, ne zgolj kot potekla.
Strojni preverjevalci dobijo iste informacije iz dokumenta JSON-LD Open Badge v2.0 na https://api.badges.ninja/certify-badge/award/<awardId>, kjer trditev vsebuje polje expires. Vsako orodje, ki bere standard, lahko uporabi svoje pravilo. Kadrovski sistem lahko potekla poverilnico takoj zavrne, imenik alumnov pa jo lahko prikaže kot »nekdaj certificiran«.
Poverilnica datum nese tudi navzven. Gumb »Add to LinkedIn« pri podelitvi izpolni mesec in leto poteka v vnosu certifikata na LinkedInu, tako da profil osebe odraža isti datum poteka, ki ste ga nastavili. Tudi PDF certifikat, ki ga lahko prenesete, poleg datuma izdaje natisne datum »Expires«.
Ena posledica, ki jo je vredno povedati naravnost: potek veljavnosti se ovrednoti v trenutku, ko nekdo pogleda, ne s postopkom, ki bi tekel pri vas. Na dan poteka poverilnice vam ni treba storiti ničesar. Nič se ne »izklopi«; stran za preverjanje preprosto pove resnico o datumu.
Pregled tega, kar bo kmalu poteklo
Programi, ki spremljajo obnove, potrebujejo seznam oseb, ki jim kmalu poteče veljavnost. Stran s podelitvami na nadzorni plošči ima stolpec Expires z datumom vsake poverilnice, ob odprtju poverilnice pa se prikaže pasica: Active, Expires on z datumom ali Expired on z datumom.

Za kampanjo obnove je najlažja pot, da izberete vrstice, ki vas zanimajo, in uporabite Export CSV. Izvoz vsebuje stolpec »Valid To«. Odprite ga v preglednici, razvrstite po tem stolpcu in v približno eni minuti imate cevovod obnov za naslednje četrtletje.
Iskreno moramo povedati eno omejitev: platforma trenutno prejemnikom sama ne pošilja samodejnih e-sporočil »vaša poverilnica kmalu poteče«. Opomnik obravnavajte kot korak v svojem procesu. Pogost vzorec je vnos v koledarju na prvi dan vsakega meseca: izvozite CSV, filtrirajte datume v naslednjih 60 do 90 dneh in tistim osebam pošljite navodila za obnovo iz svojega običajnega orodja za e-pošto. Pri večini programov z nekaj sto poverilnicami to vzame deset minut na mesec in je precej manj dela kot gradnja sistema obveščanja.
Če pa želite to avtomatizirati, končna točka seznama podelitev (GET /awards) vrača vaše poverilnice v straneh po 50, vsak zapis pa vključuje datum poteka. Načrtovan skript, ki obhodi seznam in pošlje e-pošto vsem, ki jim poteče v 60 dneh, je majhen projekt. Vendar najprej poskusite s preglednico in avtomatizirajte šele, ko vas ročni korak res boli.
Vzorci obnove
Kaj naj se zgodi s poverilnico, ko jo nekdo obnovi? Obstajajo trije razumni vzorci, pravi pa je odvisen od tega, kako je opredeljen vaš certifikacijski program.
Vzorec 1: Izdajte novo podelitev (priporočeno)
To je najčistejši pristop. Oseba opravi osvežitveno usposabljanje ali izpit za ponovno certificiranje, vi pa izdate novo podelitev iz iste značke z novim datumom izdaje in novim datumom poteka. Zdaj ima dve poverilnici z isto značko: staro, ki je prikazana kot potekla, in novo, ki je prikazana kot aktivna.
Zakaj je to običajno pravilno:
- Vsaka poverilnica beleži pošteno zgodovino: izdana na ta datum, veljavna do tega datuma.
- Stari javni URL še naprej deluje in še naprej kaže »expired«, kar je točno. Nihče, ki si ga je zaznamoval, ni zaveden.
- Nova podelitev dobi svoj URL za preverjanje, PDF certifikat in vnos Add to LinkedIn. Oseba lahko star vnos na LinkedInu zamenja ali obdrži oba, da pokaže neprekinjeno certificiranost.
- Vaša poročila lahko obnove štejejo preprosto s štetjem podelitev na prejemnika za posamezno značko.
Če želite ohraniti povezavo med staro in novo, jo zapišite v merila značke ali v svoje evidence. Značka za ponovno certificiranje lahko navaja »Obnova Annual Safety Training, velja po opravljenem osvežitvenem usposabljanju.« Če potrebujete trdo povezavo v svojem sistemu, shranite stari in novi awardId skupaj v svojo bazo za upravljanje učenja ali kadrovsko bazo, ko izdate novega.
Vzorec 2: Uredite datum poteka na mestu (samo preden je poslan)
Platforma podpira urejanje poverilnice na mestu, vendar samo dokler ni bila poslana po e-pošti in ni bila preklicana. V tem oknu lahko popravite ime prejemnika, e-pošto, datum izdaje ali datum poteka, ne da bi se spremenil URL podelitve. To je namenjeno popravljanju napak, na primer napačnega datuma poteka, vnesenega ob pripravi, ne podaljševanju poverilnice, ki jo oseba že ima.
Ko je poverilnica poslana prejemniku po e-pošti, je zaklenjena. Če jo je treba po tem spremeniti, je podprta pot, da jo prekličete in izdate novo. S tem pridemo do tretjega vzorca.
Vzorec 3: Prekličite in izdajte znova
Uporabite ga, kadar poverilnica sploh ne bi smela več veljati, na primer ker je oseba sredi obdobja izgubila licenco ali ker ste jo izdali z napačno značko. To ni običajna pot obnove, saj preklic pošilja močnejši signal kot potek: pravi, da poverilnici ne bi smeli zaupati, ne le da je njeno obdobje poteklo. Naš vodič po korakih o preklicu Open Badge pojasnjuje, kdaj je primeren kateri.
Dobro pravilo: potek pomeni, da se je obdobje končalo; preklic pomeni, da je bilo nekaj narobe. Poverilnic ne prekličite samo zato, ker so potekle. Pustite jim, da potečejo, in ohranite zapis.
Izbira obdobja veljavnosti
Datumi poteka so odločitve politike, napačne pa povzročajo prave težave. Nekaj smernic iz programov, ki jih vidimo, da dobro delujejo:
| Vrsta poverilnice | Tipična veljavnost | Opombe |
|---|---|---|
| Certifikat iz kibernetske varnosti ali IT | 2 do 3 leta | Orodja in grožnje se hitro spreminjajo |
| Letno usposabljanje o varnosti | 12 mesecev | Pogosto vezano na regulativno zahtevo |
| Prva pomoč in oživljanje | 2 leti | Sledite pravilu svojega regulatorja, ne konvenciji |
| Kreditna točka stalnega izobraževanja | Konec poročevalskega obdobja | Uskladite s ciklom, da se obnove združijo |
| Zaključek tečaja | Brez poteka | Zaključek je dejstvo; expires izpustite |
Dva praktična nasveta. Prvič, datume poteka po možnosti uskladite s koledarskim ritmom. Če vsem v skupini poteče isti datum, je obnova ena kampanja namesto petdesetih. Drugič, poteka ne dodajajte poverilnicam, ki so v resnici zapisi o zaključku. Značka, ki pravi »udeležil se je konference 2025«, naslednje leto ni nič manj resnična, datum poteka na njej pa povzroča samo zmedo.
Primer iz prakse: dveletni varnostni certifikat
Vse skupaj za izobraževalno ekipo, ki vodi certifikacijo o varnostni ozaveščenosti za podjetje s 400 zaposlenimi.
- Značko oblikujte enkrat v vizualnem oblikovalniku. Poimenujte jo, določite merila (opravljen izpit z rezultatom 80 odstotkov ali več) in v opisu navedite obdobje veljavnosti, da prejemniki vedo, za kaj se prijavljajo.
- Izdajte s potekom. Po vsakem izpitnem roku naložite seznam uspešnih prek množičnih podelitev, s potekom nastavljenim dve leti naprej. Vsak prejme e-pošto s povezavo za preverjanje, PDF certifikat in gumb Add to LinkedIn.
- Preverjajte mesečno. Na prvi dan v mesecu izvozite seznam podelitev, razvrstite po »Valid To« in izberite vse, ki jim poteče v naslednjih 90 dneh.
- Povabite jih k obnovi. Tem osebam pošljite povezavo do izpita za ponovno certificiranje iz svojega običajnega orodja za e-pošto.
- Izdajte obnovo. Ko nekdo opravi, izdajte novo podelitev iz iste značke z novim dveletnim potekom. Stara se sama prikaže kot potekla; z njo ne počnite ničesar.
- Revizorjem odgovorite s povezavo. Ko služba za skladnost vpraša, ali je oseba trenutno certificirana, pošljete URL za preverjanje. Prikaže trenutno stanje, ne da bi vam bilo treba karkoli preverjati.
Brez posebne programske opreme, brez cron opravil, brez migracij. In prav to je poanta: upravljanje življenjskega cikla je večinoma stvar izbire smiselnih datumov in mesečne navade.
Pogoste napake
- Nastavljanje poteka na vse. Prihranite ga za poverilnice, katerih pomen res bledi. Sicer ustvarjate delo z obnovami brez koristi.
- Brkanje poteka s preklicem. Preklic poteklih poverilnic uniči zgodovino neprekinjene certificiranosti in naredi, da oseba izgleda, kot da nikoli ni bila veljavna.
- Pozabljena časovna cona. Datum, ki ga izberete, postane trenutek v času. Če predpis pravi »velja do konca marca«, nastavite potek na zadnji dan marca ali prvi dan aprila, odvisno od tega, kako se bere vaša politika, in bodite dosledni.
- Načrtovanje urejanja namesto ponovne izdaje. Urejanje je mogoče samo, preden je poverilnica poslana po e-pošti. Obnove od začetka načrtujte kot nove podelitve.
- Brez procesa opomnikov. Ker obvestila o poteku niso avtomatizirana, mora navada biti vaša. Mesečni izvoz vpišite v nečiji koledar.
Kam naprej
Če bodo vaše poverilnice preverjali drugi sistemi, je vredno prebrati, kako je zgrajen dokument, ki nosi expires: Open Badge JSON-LD example walkthrough razloži vsako polje trditve. Če pa tehtate, ali boste za vse to še naprej plačevali platformi za vsako poverilnico, naša primerjava alternative za Credly prikaže stroške.
Ste pripravljeni izdati svojo prvo preverljivo poverilnico? Začnite brezplačno na badges.ninja — vizualni oblikovalnik, javna stran za preverjanje, PDF certifikat, izhod Open Badge v2.0. Kreditna kartica ni potrebna.
Kako je nastal ta članek
Nekateri prispevki na tem blogu so pripravljeni s pomočjo pomočnika UI, nato pa jih ekipa Badges Ninja pregleda, preveri dejstva in uredi pred objavo. Vsak primer kode in cena sta preverjena z dejanskim izdelkom. Več o našem uredniškem procesu in procesu UI preberite na naši strani o uredniškem procesu .

O avtorju
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.
Več od Nacho Coll
- Open Badges za programerske bootcampe: izdajanje preverljivih poverilnic v obsegu celotne kohorte19. nov. 2026 · 10min branja
- Nastavitev webhookov za dogodke značk: integracija v realnem času z vašim zaledjem16. nov. 2026 · 8min branja
- Peko Open Badge pojasnjena: kako JSON živi v PNG-ju9. nov. 2026 · 10min branja


