Platnosť a obnovenie Open Badge: správa životného cyklu časovo obmedzených osvedčení
Kredity za ďalšie vzdelávanie, certifikácie aj licencie strácajú platnosť. Nastavte expirationDate na Open Badges a obnovujte ich programovo. Schéma + pracovný postup.
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.
Niektoré osvedčenia platia nadosmrti. Diplom nepresta byť pravdivý len preto, že uplynulo desať rokov. Veľká časť osvedčení, ktoré školiace tímy vydávajú, je však opakom: dvojročná certifikácia z kybernetickej bezpečnosti, každoročné opakované školenie o bezpečnosti pri práci s vysokozdvižným vozíkom, preukaz prvej pomoci, kredit za ďalšie vzdelávanie platný len na jedno vykazovacie obdobie. Tieto osvedčenia sú vyhlásením, že niekto bol k určitému dátumu spôsobilý, a toto vyhlásenie má dobu trvanlivosti.
Ak vaše digitálne osvedčenia nikdy nevyprší, potichu hovoríte zamestnávateľom a audítorom niečo, čo nie je pravda. Tento článok vysvetľuje, ako funguje platnosť v Open Badges, čo vidí overovateľ, keď osvedčenie vyprší, a praktický postup obnovenia, ktorý nevyžaduje písanie kódu, pokiaľ nechcete.
Jedna poznámka k názvom pred začiatkom
Uvidíte, že ľudia hľadajú „expirationDate“. V špecifikácii Open Badges v2.0 sa pole na assertion (samotnom ocenení, na rozdiel od badge class) volá expires. Je to reťazec s dátumom a časom podľa ISO 8601. Pole API, ktoré posielate pri vydávaní osvedčenia na https://badges.ninja, sa tiež volá expires. Rovnaký nápad, ale iný názov, než väčšina ľudí tipuje, preto na to myslite, keď čítate dokument JSON-LD alebo hľadáte v dokumentácii.
Dva detaily, ktoré stoja za zapamätanie:
- Platnosť je súčasťou ocenenia, nie odznaku. Ten istý odznak (povedzme „Annual Safety Training“) možno vydať jednej osobe s platnosťou do marca a inej do septembra. Presne to chcete, pretože platnosť sa počíta od chvíle, keď každý človek školenie dokončil.
- Je voliteľná. Ak ju vynecháte, osvedčenie nikdy nevyprší.
Nastavenie platnosti pri vydaní
Obdobie platnosti môžete nastaviť tromi spôsobmi. Začnite prvými dvoma, pretože nepotrebujú kód.
Formulár na paneli. Keď vytvárate osvedčenie, formulár má voliteľné pole „Expires“ vedľa mena a e-mailu príjemcu. Vyberte dátum a vydajte. To je celá práca.

Hromadné ocenenia. Ak vydávate celej skupine, stránka hromadných ocenení prijme CSV s príjemcami a na celú dávku použije jeden dátum platnosti, takže trieda, ktorá skončila v rovnakom týždni, dostane rovnaký dátum skončenia platnosti. Veľkú dávku môžete pozastaviť a znovu spustiť. Náš návod na vydávanie Open Badges z CSV popisuje formát súboru.
API. Na automatizáciu, napríklad hák vo vzdelávacom systéme, ktorý vydá osvedčenie, keď niekto zloží skúšku, pridajte expires do tela POST /awards. Prijíma rovnaké formáty ako issuedOn: milisekundy od epochy alebo reťazec s dátumom 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}`;
Rovnaké volanie v Pythone:
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
Meno príjemcu musí mať aspoň päť znakov, issuedOn je povinné a úspešné volanie vráti HTTP 200 s { awardId }. Overovacia adresa URL v odpovedi nie je; zostavíte ju z identifikátora, ako je uvedené. Úplná špecifikácia požiadavky je v referenčnej príručke API ocenení.
Platforma v zákulisí normalizuje všetko, čo pošlete, na reťazec ISO 8601 a uloží ho do assertion Open Badges ako expires.
Čo vidí overovateľ
Toto je najdôležitejšia časť, pretože dátum platnosti, ktorý nikto nekontroluje, je len dekorácia.
Každé ocenenie má verejnú overovaciu stránku na https://badges.ninja/awards/<awardId> a na jej zobrazenie nie je potrebná registrácia. Stránka pri každom načítaní porovná dátum platnosti s dnešným dátumom:
- Pred dátumom skončenia platnosti: stránka zobrazí osvedčenie ako platné a uvedie riadok „valid until“ s dátumom.
- Po dátume skončenia platnosti: stránka prepne na oznámenie „Expired on“ s dátumom. Osvedčenie tam stále je, takže história zostáva zachovaná, ale nikto ho nemôže pokladať za aktuálne.
- Ak bolo osvedčenie odvolané: odvolanie má prednosť pred skončením platnosti. Odvolané osvedčenie sa zobrazí ako odvolané, nie len ako vypršané.
Strojoví overovatelia dostanú rovnakú informáciu z dokumentu JSON-LD Open Badge v2.0 na https://api.badges.ninja/certify-badge/award/<awardId>, kde assertion nesie pole expires. Každý nástroj, ktorý číta štandard, môže uplatniť vlastnú politiku. HR systém môže vypršané osvedčenie rovno odmietnuť, zatiaľ čo adresár absolventov ho môže zobraziť ako „bývalý držiteľ certifikácie“.
Osvedčenie nesie dátum aj navonok. Tlačidlo „Add to LinkedIn“ na ocenení vyplní mesiac a rok skončenia platnosti v zázname o certifikácii na LinkedIne, takže profil osoby odráža rovnaký dátum, aký ste nastavili. Stiahnuteľný PDF certifikát tiež vytlačí dátum „Expires“ vedľa dátumu vydania.
Jeden dôsledok, ktorý stojí za to povedať otvorene: platnosť sa vyhodnocuje v okamihu, keď sa niekto pozrie, nie úlohou, ktorá beží na vašej strane. V deň, keď osvedčenie vyprší, nemusíte robiť nič. Nič sa „nevypína“; overovacia stránka jednoducho hovorí pravdu o dátume.
Ako zistiť, čo čoskoro vyprší
Programy, ktoré sledujú obnovenia, potrebujú zoznam toho, komu sa blíži termín. Stránka ocenení na paneli má stĺpec Expires s dátumom každého osvedčenia a otvorenie osvedčenia zobrazí banner: Active, Expires on dátum alebo Expired on dátum.

Pre kampaň obnovenia je najjednoduchšie vybrať riadky, ktoré vás zaujímajú, a použiť Export CSV. Export obsahuje stĺpec „Valid To“. Otvorte ho v tabuľke, zoraďte podľa tohto stĺpca a za asi minútu máte zásobník obnovení na nasledujúci štvrťrok.
Musíme byť úprimní v jednom obmedzení: platforma momentálne sama neposiela príjemcom automatické e-maily „vaše osvedčenie čoskoro vyprší“. Pripomienku berte ako krok vo vlastnom procese. Bežným vzorom je záznam v kalendári na prvého v mesiaci: exportujte CSV, odfiltrujte dátumy v nasledujúcich 60 až 90 dňoch a týmto ľuďom pošlite pokyny na obnovenie zo svojho bežného e-mailového nástroja. Pri väčšine programov s niekoľkými stovkami osvedčení to zaberie desať minút mesačne a je to oveľa menej práce než budovanie systému upozornení.
Ak to predsa chcete automatizovať, koncový bod zoznamu ocenení (GET /awards) vracia vaše osvedčenia po 50 na stranu a každý záznam obsahuje svoj dátum platnosti. Plánovaný skript, ktorý prejde zoznam a pošle e-mail každému, komu platnosť skončí do 60 dní, je malý projekt. Najprv však vyskúšajte tabuľku a automatizujte, až keď vás ručný krok naozaj tlačí.
Vzory obnovenia
Keď niekto obnoví, čo by sa malo stať s osvedčením? Existujú tri rozumné vzory a ten správny závisí od toho, ako je definovaný váš certifikačný program.
Vzor 1: Vydajte nové ocenenie (odporúčané)
Toto je najčistejší prístup. Osoba absolvuje opakované školenie alebo skúšku na recertifikáciu a vy vydáte nové ocenenie z toho istého odznaku s novým dátumom vydania a novým dátumom skončenia platnosti. Teraz má dve osvedčenia s tým istým odznakom: staré, ktoré sa zobrazuje ako vypršané, a nové, ktoré sa zobrazuje ako aktívne.
Prečo je to zvyčajne správne:
- Každé osvedčenie zaznamenáva poctivú históriu: vydané v tento deň, platné do toho dňa.
- Stará verejná URL naďalej funguje a naďalej hovorí „expired“, čo je presné. Nikto, kto si ju uložil, nie je uvedený do omylu.
- Nové ocenenie dostane vlastnú overovaciu URL, PDF certifikát a záznam Add to LinkedIn. Osoba môže starý záznam na LinkedIne nahradiť alebo ponechať oba, aby preukázala nepretržitú certifikáciu.
- Vaše prehľady môžu počítať obnovenia jednoducho počítaním ocenení na príjemcu pre daný odznak.
Aby ste zachovali prepojenie medzi starým a novým, uveďte ho v kritériách odznaku alebo vo vlastných záznamoch. Odznak recertifikácie môže uvádzať „Obnovenie Annual Safety Training, platné po absolvovaní opakovaného školenia.“ Ak potrebujete pevné prepojenie vo vlastnom systéme, pri vydaní nového ukladajte staré a nové hodnoty awardId spolu vo svojej databáze vzdelávacieho systému alebo HR.
Vzor 2: Upravte platnosť priamo (iba pred odoslaním)
Platforma podporuje úpravu osvedčenia priamo, ale iba kým nebolo odoslané e-mailom a nebolo odvolané. V tomto okne môžete opraviť meno príjemcu, e-mail, dátum vydania alebo dátum skončenia platnosti bez zmeny URL ocenenia. Je to na opravu chýb, napríklad nesprávne zadaného dátumu platnosti pri nastavovaní, nie na predĺženie osvedčenia, ktoré už niekto drží.
Keď je osvedčenie odoslané príjemcovi e-mailom, je zamknuté. Ak ho potrebujete po tomto momente zmeniť, podporovaným postupom je odvolať ho a vydať nové. Tým sa dostávame k tretiemu vzoru.
Vzor 3: Odvolajte a vydajte znova
Použite to, keď by osvedčenie už vôbec nemalo byť považované za platné, napríklad osoba stratila licenciu uprostred obdobia alebo ste ho vydali s nesprávnym odznakom. Nie je to bežná cesta obnovenia, pretože odvolanie vysiela silnejší signál než skončenie platnosti: hovorí, že osvedčeniu sa nemalo dôverovať, nielen že jeho obdobie skončilo. Náš návod krok za krokom na odvolanie Open Badge vysvetľuje, kedy je vhodné ktoré.
Dobré pravidlo: skončenie platnosti znamená, že obdobie skončilo; odvolanie znamená, že niečo nebolo v poriadku. Neodvolávajte osvedčenia len preto, že vypršali. Nechajte ich vypršať a záznam zachovajte.
Výber obdobia platnosti
Dátumy skončenia platnosti sú politické rozhodnutia a ich nesprávne nastavenie spôsobuje skutočné problémy. Niekoľko odporúčaní z programov, ktoré podľa nás fungujú dobre:
| Typ osvedčenia | Typická platnosť | Poznámky |
|---|---|---|
| Certifikácia z kybernetickej bezpečnosti alebo IT | 2 až 3 roky | Nástroje a hrozby sa rýchlo menia |
| Každoročné školenie bezpečnosti | 12 mesiacov | Často viazané na regulačnú požiadavku |
| Prvá pomoc a CPR | 2 roky | Riaďte sa pravidlom svojho regulátora, nie zvykom |
| Kredit za ďalšie vzdelávanie | Koniec vykazovacieho obdobia | Zosúlaďte s cyklom, aby sa obnovenia zoskupili |
| Absolvovanie kurzu | Bez platnosti | Absolvovanie je fakt; expires vynechajte |
Dva praktické tipy. Po prvé, kde sa dá, zosúlaďte dátumy skončenia platnosti s kalendárnym rytmom. Ak všetci v skupine vypršia v ten istý deň, obnovenie sa stane jednou kampaňou namiesto päťdesiatich. Po druhé, nedávajte dátum platnosti osvedčeniam, ktoré sú v skutočnosti záznamami o absolvovaní. Odznak, ktorý hovorí „zúčastnil sa konferencie 2025“, sa v budúcom roku nestane menej pravdivým a dátum platnosti na ňom len spôsobuje zmätok.
Príklad z praxe: dvojročná bezpečnostná certifikácia
Poskladajme to pre školiaci tím, ktorý vedie certifikáciu povedomia o bezpečnosti pre firmu so 400 zamestnancami.
- Navrhnite odznak raz vo vizuálnom dizajnéri. Pomenujte ho, nastavte kritériá (zloženie skúšky so skóre 80 percent alebo viac) a obdobie platnosti popíšte v opise, aby príjemcovia vedeli, na čo sa prihlasujú.
- Vydávajte s dátumom platnosti. Po každom skúšobnom termíne nahrajte zoznam úspešných cez hromadné ocenenia s platnosťou nastavenou o dva roky. Každý dostane svoj e-mail s overovacím odkazom, PDF certifikátom a tlačidlom Add to LinkedIn.
- Kontrolujte mesačne. Prvého v mesiaci exportujte zoznam ocenení, zoraďte podľa „Valid To“ a vyberte všetkých, ktorým platnosť skončí v nasledujúcich 90 dňoch.
- Pozvite ich na obnovenie. Týmto ľuďom pošlite odkaz na recertifikačnú skúšku zo svojho bežného e-mailového nástroja.
- Vydajte obnovenie. Keď niekto uspeje, vydajte nové ocenenie z toho istého odznaku s novou dvojročnou platnosťou. Staré sa zobrazí ako vypršané samo; nerobte s ním nič.
- Audítorom odpovedajte odkazom. Keď oddelenie súladu položí otázku, či je daná osoba momentálne certifikovaná, pošlete overovaciu URL. Zobrazí aktuálny stav bez toho, aby ste čokoľvek kontrolovali.
Žiadny vlastný softvér, žiadne cron úlohy, žiadne migrácie. To je podstata: správa životného cyklu je väčšinou otázkou výberu rozumných dátumov a mesačného návyku.
Časté chyby
- Nastavenie platnosti na všetko. Vyhraďte ju pre osvedčenia, ktorých význam skutočne bledne. Inak vytvárate prácu s obnovovaním bez prínosu.
- Zamieňanie skončenia platnosti a odvolania. Odvolanie vypršaných osvedčení ničí históriu nepretržitej certifikácie a spôsobí, že osoba vyzerá, akoby nikdy nebola platná.
- Zabudnutie na časové pásmo. Dátum, ktorý vyberiete, sa stane okamihom v čase. Ak predpis hovorí „platné do konca marca“, nastavte platnosť na posledný deň marca alebo prvý deň apríla podľa toho, ako vaša politika znie, a buďte dôslední.
- Plánovanie úpravy namiesto opätovného vydania. Úprava je dostupná iba pred odoslaním osvedčenia e-mailom. Obnovenia plánujte od začiatku ako nové ocenenia.
- Žiadny proces pripomienok. Keďže upozornenia na skončenie platnosti nie sú automatické, návyk musí byť váš. Dajte mesačný export niekomu do kalendára.
Kam ďalej
Ak budú vaše osvedčenia kontrolovať iné systémy, oplatí sa prečítať, ako je štruktúrovaný dokument, ktorý nesie expires: Prehľad príkladu Open Badge JSON-LD prechádza každé pole assertion. A ak zvažujete, či ďalej platiť platforme za každé osvedčenie, naše porovnanie alternatívy ku Credly uvádza náklady.
Ste pripravení vydať svoje prvé overiteľné osvedčenie? Začnite zadarmo vo badges.ninja — vizuálny dizajnér, verejná overovacia stránka, PDF certifikát, výstup Open Badge v2.0. Bez kreditnej karty.
Ako vznikol tento článok
Niektoré príspevky na tomto blogu vznikajú s pomocou AI asistenta a pred publikovaním ich kontroluje, overuje a upravuje tím Badges Ninja. Každá ukážka kódu a cena je overená priamo v produkte. Viac o našom redakčnom a AI procese nájdete na našej stránke o redakčnom procese .

O autorovi
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.
Viac od Nacho Coll
- Open Badges pre programátorské bootcampy: overiteľné osvedčenia v rozsahu celého ročníka19. 11. 2026 · 10min čítania
- Nastavenie webhookov pre udalosti odznakov: integrácia v reálnom čase s vaším backendom16. 11. 2026 · 8min čítania
- Baking Open Badge vysvetlený: ako JSON žije vnútri PNG9. 11. 2026 · 10min čítania


