Истек рока и обнављање Open Badge-а: управљање животним веком временски ограничених акредитива
Кредити за континуирано образовање, сертификати и лиценце истичу. Подесите expirationDate на Open Badges и обнављајте их програмски. Шема + радни ток.
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.
Неки акредитиви важе доживотно. Диплома не престаје да буде истинита зато што је прошло десет година. Али велики део акредитива које тимови за обуку издају је управо супротан: двогодишњи сертификат из сајбер безбедности, годишње освежавање обуке о безбедности рада са виљушкарима, CPR картица, кредит за континуирано образовање који важи само за један извештајни циклус. Ови акредитиви су изјава да је неко био компетентан на одређени датум, а та изјава има рок трајања.
Ако ваши дигитални акредитиви никада не истичу, ви послодавцима и ревизорима тихо говорите нешто што није тачно. Овај чланак објашњава како истек рока функционише у Open Badges, шта верификатор види када акредитив истекне и практичан радни ток обнављања који не захтева писање кода, осим ако то не желите.
Једна напомена о називима пре почетка
Видећете да људи траже „expirationDate“. У спецификацији Open Badges v2.0 поље на assertion-у (самој награди, за разлику од badge class-а) зове се expires. То је ISO 8601 стринг са датумом и временом. Поље API-ја које шаљете при издавању акредитива на https://badges.ninja такође се зове expires. Иста идеја, али са називом другачијим од оног који већина људи претпоставља, па то имајте на уму када читате JSON-LD документ или претражујете документацију.
Два детаља која вреди знати:
- Рок важења је део награде, а не значке. Иста значка (рецимо „Annual Safety Training“) може да се изда једној особи са истеком у марту, а другој са истеком у септембру. То и желите, јер се важење рачуна од тренутка када је свака особа завршила обуку.
- Необавезан је. Ако га изоставите, акредитив никада не истиче.
Подешавање рока при издавању
Имате три начина да подесите период важења. Почните са прва два, јер не захтевају код.
Образац на контролној табли. Када креирате акредитив, образац има необавезно поље „Expires“ поред имена и имејла примаоца. Изаберите датум и издајте. То је цео посао.

Масовне награде. Ако издајете целој групи, страница за масовне награде прима CSV са примаоцима и примењује један датум истека на цео пакет, тако да класа која је завршила исте недеље добија исти датум истека. Велики пакет можете паузирати и наставити. Наш водич за издавање Open Badges из CSV-а описује формат фајла.
API. За аутоматизацију, на пример куку у систему за управљање учењем која издаје акредитив када неко положи испит, додајте expires у тело POST /awards. Прихвата исте формате као issuedOn: милисекунде од епохе или 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}`;
Исти позив у 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
Име примаоца мора да има најмање пет знакова, issuedOn је обавезан, а успешан позив враћа HTTP 200 са { awardId }. URL за верификацију није у одговору; градите га од идентификатора као што је приказано. Цео уговор захтева налази се у референци за API награда.
Иза кулиса, платформа све што пошаљете нормализује у ISO 8601 стринг и чува га у Open Badges assertion-у као expires.
Шта верификатор види
Ово је најважнији део, јер је датум истека који нико не проверава само украс.
Свака награда има јавну страницу за верификацију на https://badges.ninja/awards/<awardId>, а за њен приказ није потребна регистрација. Страница при сваком учитавању упоређује датум истека са данашњим датумом:
- Пре датума истека: страница приказује акредитив као важећи и исписује ред „valid until“ са датумом.
- После датума истека: страница прелази на обавештење „Expired on“ са датумом. Акредитив је и даље ту, па је историја очувана, али га нико не може заменити за текући.
- Ако је акредитив опозван: опозив има предност над истеком. Опозван акредитив се приказује као опозван, а не само као истекао.
Машински верификатори исте информације добијају из Open Badge v2.0 JSON-LD документа на https://api.badges.ninja/certify-badge/award/<awardId>, где assertion носи поље expires. Сваки алат који чита стандард може да примени сопствену политику. HR систем може одмах да одбије истекао акредитив, док именик алумниста може да га прикаже као „некада сертификован“.
Акредитив носи датум и даље. Дугме „Add to LinkedIn“ на награди попуњава месец и годину истека у LinkedIn уносу сертификата, тако да профил особе одражава исти датум истека који сте подесили. Преузимљиви PDF сертификат такође штампа датум „Expires“ поред датума издавања.
Једна последица коју вреди јасно рећи: истек се процењује у тренутку када неко погледа, а не помоћу посла који се извршава код вас. Не морате ништа да радите оног дана када акредитив истекне. Ништа се не „искључује“; страница за верификацију једноставно говори истину о датуму.
Како видети шта ускоро истиче
Програмима који прате обнављања потребан је списак ко ускоро треба да обнови. Страница са наградама на контролној табли има колону Expires која приказује датум сваког акредитива, а отварање акредитива показује банер: Active, Expires on датум или Expired on датум.

За кампању обнављања, најлакши пут је да изаберете редове који вас занимају и употребите Export CSV. Извоз укључује колону „Valid To“. Отворите га у табели, сортирајте по тој колони и за отприлике минут имате пајплајн обнављања за следеће тромесечје.
Морамо бити искрени у вези са једним ограничењем: платформа тренутно сама не шаље аутоматске имејлове „ваш акредитив ускоро истиче“ примаоцима. Подсетник третирајте као корак у сопственом процесу. Уобичајен образац је ставка у календару првог у месецу: извезите CSV, филтрирајте датуме у наредних 60 до 90 дана и тим људима пошаљите упутства за обнављање из свог уобичајеног алата за имејл. За већину програма са неколико стотина акредитива ово одузима десет минута месечно и далеко је мање посла од изградње система за обавештавање.
Ако ипак желите да га аутоматизујете, endpoint за списак награда (GET /awards) враћа ваше акредитиве у страницама од по 50, а сваки запис садржи свој рок истека. Скрипта по распореду која прође кроз списак и пошаље имејл свима којима рок истиче у наредних 60 дана је мали пројекат. Али прво пробајте табелу и аутоматизујте тек када вас ручни корак стварно омета.
Обрасци обнављања
Када неко обнови, шта треба да се деси са акредитивом? Постоје три разумна обрасца, а прави зависи од тога како је дефинисан ваш програм сертификације.
Образац 1: Издајте нову награду (препоручено)
Ово је најчистији приступ. Особа заврши освежавање или испит за поновну сертификацију, а ви издајете нову награду са исте значке са новим датумом издавања и новим роком истека. Сада она има два акредитива са истом значком: стари, који се приказује као истекао, и нови, који се приказује као активан.
Зашто је ово обично исправно:
- Сваки акредитив бележи поштену историју: издат тог датума, важи до тог датума.
- Стари јавни URL наставља да ради и наставља да каже „expired“, што је тачно. Нико ко га је сачувао није доведен у заблуду.
- Нова награда добија сопствени URL за верификацију, PDF сертификат и Add to LinkedIn унос. Особа може да замени стари LinkedIn унос или да задржи оба како би показала континуирану сертификацију.
- Ваши извештаји могу да броје обнављања једноставно бројањем награда по примаоцу за једну значку.
Да бисте задржали везу између старог и новог, упишите је у критеријуме значке или у своје евиденције. Значка за поновну сертификацију може да каже „Обнова Annual Safety Training, важи након завршетка освежавања.“ Ако вам је потребна чврста веза у вашем систему, чувајте старе и нове вредности awardId заједно у својој бази система за учење или HR бази када издајете нову.
Образац 2: Измените рок на месту (само пре слања)
Платформа подржава измену акредитива на месту, али само док није послат имејлом и док није опозван. У том прозору можете да исправите име примаоца, имејл, датум издавања или датум истека без промене URL-а награде. Ово је за исправљање грешака, као што је погрешно унет датум истека током подешавања, а не за продужавање акредитива који неко већ поседује.
Када је акредитив послат примаоцу имејлом, он је закључан. Ако морате да га мењате након тога, подржан пут је да га опозовете и издате нови. То нас води до трећег обрасца.
Образац 3: Опозовите и поново издајте
Користите ово када акредитив уопште не треба више сматрати важећим, на пример особа је изгубила лиценцу усред рока или сте га издали са погрешном значком. То није уобичајени пут обнављања, јер опозив шаље јачи сигнал од истека: говори да акредитиву није требало веровати, а не само да му је рок истекао. Наш водич корак по корак о опозиву Open Badge-а објашњава када је шта прикладно.
Добро правило: истек значи да је рок завршен; опозив значи да је нешто било погрешно. Не опозивајте акредитиве само зато што су истекли. Пустите их да истекну и сачувајте запис.
Избор периода важења
Рокови истека су одлуке политике, а њихово погрешно подешавање ствара праве главобоље. Неколико смерница из програма за које видимо да добро раде:
| Врста акредитива | Уобичајено важење | Напомене |
|---|---|---|
| Сертификат из сајбер безбедности или ИТ-а | 2 до 3 године | Алати и претње се брзо мењају |
| Годишња обука о безбедности | 12 месеци | Често везана за законску обавезу |
| Прва помоћ и CPR | 2 године | Следите правило свог регулатора, а не конвенцију |
| Кредит за континуирано образовање | Крај извештајног циклуса | Ускладите са циклусом да се обнављања групишу |
| Завршетак курса | Без истека | Завршетак је чињеница; изоставите expires |
Два практична савета. Прво, где год можете, ускладите датуме истека са календарским ритмом. Ако сви у једној групи истичу истог датума, обнављање постаје једна кампања уместо педесет. Друго, не стављајте рок истека на акредитиве који су заправо евиденција о завршетку. Значка која каже „присуствовао конференцији 2025“ не постаје мање истинита следеће године, а датум истека на њој само ствара забуну.
Радни пример: двогодишњи сертификат из безбедности
Да све сложимо за тим за обуку који води сертификацију о свести о безбедности у компанији са 400 запослених.
- Дизајнирајте значку једном у визуелном дизајнеру. Дајте јој име, поставите критеријуме (положен испит са резултатом од 80 процената или више) и опишите период важења у опису како би примаоци знали на шта пристају.
- Издајте са роком истека. После сваког испитног рока отпремите списак оних који су положили кроз масовне награде са истеком за две године. Свако добија свој имејл са линком за верификацију, PDF сертификатом и дугметом Add to LinkedIn.
- Проверавајте месечно. Првог у месецу извезите списак награда, сортирајте по „Valid To“ и издвојте све којима рок истиче у наредних 90 дана.
- Позовите их да обнове. Тим људима пошаљите линк ка испиту за поновну сертификацију из свог уобичајеног алата за имејл.
- Издајте обнову. Када неко положи, издајте нову награду са исте значке са новим двогодишњим роком. Стара се сама приказује као истекла; не радите ништа са њом.
- Одговарајте ревизорима линком. Када служба усклађености пита да ли је нека особа тренутно сертификована, шаљете URL за верификацију. Он приказује тренутни статус без икакве ваше провере.
Без посебног софтвера, без cron послова, без миграција. То је поента: управљање животним веком је углавном питање избора разумних датума и месечне навике.
Честе грешке
- Постављање рока на све. Оставите га за акредитиве чије значење заиста бледи. У супротном стварате посао обнављања без користи.
- Мешање истека и опозива. Опозивање истеклих акредитива уништава историју континуиране сертификације и чини да особа изгледа као да никада није била важећа.
- Заборављање временске зоне. Датум који изаберете постаје тренутак у времену. Ако пропис каже „важи до краја марта“, поставите рок на последњи дан марта или на први дан априла, зависно од тога како ваша политика то тумачи, и будите доследни.
- Планирање измене уместо поновног издавања. Измена је доступна само пре него што се акредитив пошаље имејлом. Обнављања планирајте као нове награде од почетка.
- Одсуство процеса подсећања. Пошто обавештења о истеку нису аутоматска, навика мора бити ваша. Ставите месечни извоз некоме у календар.
Куда даље
Ако ће ваше акредитиве проверавати други системи, вреди прочитати како је структуриран документ који носи expires: Приказ примера Open Badge JSON-LD-а пролази кроз свако поље assertion-а. А ако размишљате да ли да и даље плаћате платформи по акредитиву за све ово, наше поређење алтернативе за Credly приказује трошкове.
Спремни да издате свој први проверљиви акредитив? Започните бесплатно на badges.ninja — визуелни дизајнер, јавна страница за верификацију, PDF сертификат, излаз Open Badge v2.0. Без кредитне картице.
Како је овај чланак настао
Неки текстови на овом блогу настају уз помоћ ВИ асистента, а затим их проверава, чињенично потврђује и уређује тим Badges Ninja пре објављивања. Сваки код и цена се проверавају у односу на актуелни производ. Више о нашем уредничком и ВИ процесу прочитајте на нашој страници о уредничком процесу .

О аутору
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.
Више од Nacho Coll
- Open Badges за кодинг бутцампове: верификована уверења у размери целе генерације19. нов 2026. · 10мин читања
- Подешавање вебхукова за догађаје са значкама: интеграција у реалном времену са вашим бекендом16. нов 2026. · 8мин читања
- Baking за Open Badge: како JSON живи унутар PNG-а9. нов 2026. · 10мин читања


