Строк дії та поновлення Open Badge: керування життєвим циклом обмежених у часі посвідчень
Кредити CE, сертифікації та ліцензії завершуються. Задайте 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 поле в засвідченні (тобто в самій видачі, на відміну від класу значка) називається 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 як expires.
Що бачить верифікатор
Це найважливіша частина, адже дата завершення, яку ніхто не перевіряє, — лише декорація.
Кожна видача має публічну сторінку верифікації за адресою https://badges.ninja/awards/<awardId>, і для її перегляду реєструватися не потрібно. Сторінка порівнює дату завершення з сьогоднішньою датою щоразу, коли завантажується:
- До дати завершення: сторінка показує посвідчення як чинне й відображає рядок «valid until» з датою.
- Після дати завершення: сторінка перемикається на повідомлення «Expired on» з датою. Посвідчення залишається на місці, тож історія збережена, але ніхто не сплутає його з чинним.
- Якщо посвідчення було відкликано: відкликання має пріоритет над завершенням строку. Відкликане посвідчення показується як відкликане, а не просто прострочене.
Машинні верифікатори отримують ту саму інформацію з документа JSON-LD Open Badge v2.0 за адресою https://api.badges.ninja/certify-badge/award/<awardId>, де засвідчення містить поле 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 example walkthrough розбирає кожне поле засвідчення. А якщо ви зважуєте, чи й далі платити платформі за кожне посвідчення, наше порівняння альтернатив 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.


