Срок на валидност и подновяване на 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 и го съхранява в assertion на Open Badges като expires.
Какво вижда верификаторът
Това е най-важната част, защото дата на изтичане, която никой не проверява, е само украса.
Всяка награда има публична страница за верификация на https://badges.ninja/awards/<awardId> и не е нужна регистрация, за да се види. Страницата сравнява датата на изтичане с днешната дата при всяко зареждане:
- Преди датата на изтичане: страницата показва удостоверението като валидно и изписва ред „valid until“ с датата.
- След датата на изтичане: страницата превключва към съобщение „Expired on“ с датата. Удостоверението все още е там, така че историята е запазена, но никой не може да го вземе за текущо.
- Ако удостоверението е отменено: отмяната има предимство пред изтичането. Отмененото удостоверение се показва като отменено, а не просто като изтекло.
Машинните верификатори получават същата информация от JSON-LD документа на Open Badge v2.0 на 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 дни и изпратете на тези хора указанията за подновяване от обичайния си инструмент за имейл. За повечето програми с няколкостотин удостоверения това отнема десет минути месечно и е много по-малко работа от изграждането на система за известия.
Ако все пак искате да го автоматизирате, крайната точка за списък с награди (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. Без кредитна карта.
Как беше създадена тази статия
Някои публикации в този блог се изготвят с помощта на AI асистент, след което се преглеждат, проверяват и редактират от екипа на Badges Ninja преди публикуване. Всеки примерен код и цена се проверяват спрямо реалния продукт. Прочетете повече за нашия редакционен и AI процес на нашата страница за редакционния процес .

За автора
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.11.2026 г. · 11мин четене
- Настройване на уебхукове за събития със значки: интеграция в реално време с вашия бекенд16.11.2026 г. · 9мин четене
- Baking на Open Badge: как JSON живее вътре в PNG9.11.2026 г. · 11мин четене


