Срок действия и продление Open Badges: управление жизненным циклом ограниченных по времени credentials
Баллы непрерывного образования, сертификации и лицензии истекают. Задавайте 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.
Одни credentials действуют всю жизнь. Диплом не перестаёт быть правдой оттого, что прошло десять лет. Но значительная часть credentials, которые выдают учебные отделы, — ровно наоборот: двухлетняя сертификация по кибербезопасности, ежегодный курс по технике безопасности для водителей погрузчиков, карточка по СЛР, балл непрерывного образования, действительный только в одном отчётном цикле. Такие credentials — это утверждение, что человек был компетентен на определённую дату, и у этого утверждения есть срок годности.
Если ваши цифровые credentials никогда не истекают, вы тихо сообщаете работодателям и аудиторам то, что неправда. В этой статье разберём, как срок действия работает в Open Badges, что видит верификатор, когда credential истёк, и практичный процесс продления, для которого не нужно писать код — если вы сами этого не захотите.
Одно замечание об именах перед началом
Люди ищут «expirationDate». В спецификации Open Badges v2.0 поле assertion (самой выдачи, в отличие от класса значка) называется expires. Это строка даты и времени в формате ISO 8601. Поле API, которое вы отправляете при выдаче credential на https://badges.ninja, тоже называется expires. Та же идея, но имя не такое, как большинство предполагает, — держите это в голове, когда читаете документ JSON-LD или ищете в документации.
Два важных момента:
- Срок действия относится к выдаче, а не к значку. Один и тот же значок (скажем, «Annual Safety Training») можно выдать одному человеку со сроком в марте, а другому — в сентябре. Именно это и нужно, ведь срок отсчитывается от момента, когда каждый прошёл обучение.
- Он необязателен. Не укажете — credential не истечёт никогда.
Как задать срок при выдаче
Есть три способа задать срок действия. Начните с первых двух — они не требуют кода.
Форма в панели управления. При создании credential в форме рядом с именем и email получателя есть необязательное поле даты «Expires». Выберите дату и выдайте. Вот и вся работа.

Массовая выдача. Если вы выдаёте целой группе, страница массовых выдач принимает CSV с получателями и применяет одну дату окончания ко всей партии, так что класс, закончивший обучение в одну неделю, получает одну дату истечения. Большую партию можно приостановить и возобновить. Формат файла описан в нашей инструкции по выдаче Open Badges из CSV.
API. Для автоматизации, например хука системы управления обучением, который выдаёт credential, когда человек сдаёт экзамен, добавьте 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 awards.
За кулисами платформа приводит всё, что вы отправили, к строке ISO 8601 и сохраняет её в assertion Open Badges как expires.
Что видит верификатор
Это самое важное, ведь дата окончания, которую никто не проверяет, — просто украшение.
У каждой выдачи есть публичная страница верификации https://badges.ninja/awards/<awardId>, для просмотра которой регистрация не нужна. При каждой загрузке страница сравнивает дату окончания с сегодняшней:
- До даты окончания: страница показывает credential как действительный и выводит строку «действителен до» с датой.
- После даты окончания: страница переключается на уведомление «Истёк» с датой. Credential остаётся на месте, история сохраняется, но принять его за действующий невозможно.
- Если credential отозван: отзыв имеет приоритет над истечением. Отозванный credential отображается как отозванный, а не просто как истёкший.
Машинные верификаторы получают ту же информацию из документа Open Badge v2.0 JSON-LD по адресу https://api.badges.ninja/certify-badge/award/<awardId>, где в assertion есть поле expires. Любой инструмент, читающий стандарт, может применить собственную политику. HR-система может отклонить истёкший credential целиком, а каталог выпускников — показать его как «ранее сертифицирован».
Credential также передаёт дату дальше. Кнопка «Add to LinkedIn» на странице выдачи заполняет месяц и год окончания в записи о сертификации в LinkedIn, так что профиль человека отражает ту же дату, что задали вы. В загружаемом PDF-сертификате рядом с датой выдачи тоже печатается дата «Expires».
Следствие, которое стоит назвать прямо: истечение вычисляется в момент, когда кто-то смотрит, а не заданием, которое выполняется на вашей стороне. В день окончания срока вам ничего делать не нужно. Ничего не «отключается»; страница верификации просто говорит правду о дате.
Что скоро истечёт
Программам, отслеживающим продления, нужен список тех, кому скоро продлевать. На странице awards в панели управления есть столбец Expires с датой каждого credential, а при открытии credential показывается баннер: Active, Expires on a date или Expired on a date.

Для кампании по продлению проще всего выбрать нужные строки и нажать Export CSV. В экспорт входит столбец «Valid To». Откройте его в таблице, отсортируйте по этому столбцу — и примерно за минуту у вас готов план продлений на следующий квартал.
Об одном ограничении скажем честно: платформа сейчас сама не отправляет получателям автоматические письма «срок вашего credential скоро истекает». Считайте напоминание шагом вашего собственного процесса. Типичный приём — запись в календаре на первое число каждого месяца: выгрузить CSV, отфильтровать даты в ближайшие 60–90 дней и отправить этим людям инструкции по продлению из вашего обычного почтового инструмента. Для большинства программ с несколькими сотнями credentials это десять минут в месяц, и работы гораздо меньше, чем при создании системы уведомлений.
Если всё же хотите автоматизировать, эндпоинт списка awards (GET /awards) возвращает ваши credentials страницами по 50, и каждая запись содержит срок окончания. Запланированный скрипт, который обходит список и пишет всем, у кого срок истекает в течение 60 дней, — небольшой проект. Но сначала попробуйте таблицу и автоматизируйте, только когда ручной шаг действительно мешает.
Схемы продления
Что должно произойти с credential, когда человек продлевает его? Есть три разумные схемы, и правильная зависит от того, как определена ваша программа сертификации.
Схема 1: выдать новую выдачу (рекомендуется)
Это самый чистый подход. Человек проходит курс повторения или экзамен на пересертификацию, а вы выдаёте новую выдачу того же значка с новой датой выдачи и новой датой окончания. Теперь у него два credentials с одним значком: старый, отображаемый как истёкший, и новый, отображаемый как действующий.
Почему это обычно правильно:
- Каждый credential честно фиксирует историю: выдан в такую-то дату, действителен до такой-то.
- Старый публичный URL продолжает работать и продолжает сообщать «истёк», что соответствует действительности. Никто, сохранивший его в закладках, не введён в заблуждение.
- Новая выдача получает собственный URL верификации, PDF-сертификат и запись Add to LinkedIn. Человек может заменить старую запись в LinkedIn или оставить обе, показывая непрерывную сертификацию.
- В отчётах продления считаются просто как число выдач одного значка на получателя.
Чтобы сохранить связь между старым и новым, укажите её в критериях значка или в собственных записях. Значок пересертификации может гласить: «Продление Annual Safety Training, действителен после прохождения курса повторения». Если нужна жёсткая связь в вашей системе, сохраняйте старый и новый awardId вместе в базе системы обучения или HR при выдаче нового.
Схема 2: изменить срок на месте (только до отправки)
Платформа позволяет редактировать credential на месте, но только пока он не отправлен по email и не отозван. В этом окне можно исправить имя получателя, email, дату выдачи или дату окончания, не меняя URL выдачи. Это для исправления ошибок, например неверно введённой при настройке даты окончания, а не для продления credential, который у человека уже есть.
После отправки credential получателю по email он блокируется. Если после этого его нужно изменить, поддерживаемый путь — отозвать его и выдать новый. Это подводит нас к третьей схеме.
Схема 3: отозвать и выдать заново
Используйте её, когда credential вообще не должен считаться действительным, например человек потерял лицензию посреди срока или вы выдали его не с тем значком. Это не обычный путь продления, потому что отзыв сигнализирует сильнее, чем истечение: он говорит, что credential не следовало доверять, а не просто что его срок закончился. Наша пошаговая инструкция по отзыву Open Badge объясняет, когда уместно что.
Хорошее правило: истечение означает, что срок закончился; отзыв означает, что что-то было не так. Не отзывайте credentials только потому, что они истекли. Дайте им истечь и сохраните запись.
Как выбрать срок действия
Сроки окончания — это решения политики, и ошибки в них создают реальные проблемы. Несколько советов из программ, которые работают хорошо:
| Тип credential | Типичный срок | Примечания |
|---|---|---|
| Сертификация по кибербезопасности или IT | 2–3 года | Инструменты и угрозы быстро меняются |
| Ежегодное обучение технике безопасности | 12 месяцев | Часто привязано к нормативному требованию |
| Первая помощь и СЛР | 2 года | Следуйте правилу вашего регулятора, а не обычаю |
| Балл непрерывного образования | Конец отчётного цикла | Совместите с циклом, чтобы продления шли пакетом |
| Завершение курса | Без срока | Завершение — это факт; не указывайте expires |
Два практических совета. Во-первых, по возможности привязывайте даты окончания к календарному ритму. Если вся группа истекает в один день, продление превращается в одну кампанию вместо пятидесяти. Во-вторых, не ставьте срок на credentials, которые на деле являются записями о завершении. Значок «участвовал в конференции 2025 года» не становится менее правдивым в следующем году, а дата окончания на нём лишь вносит путаницу.
Разбор примера: двухлетняя сертификация по безопасности
Соберём всё вместе для учебной команды, которая проводит сертификацию по информационной безопасности в компании на 400 сотрудников.
- Один раз разработайте значок в визуальном дизайнере. Назовите его, задайте критерии (сдать экзамен с результатом не менее 80 процентов) и опишите срок действия в описании, чтобы получатели знали, на что подписываются.
- Выдавайте со сроком. После каждой экзаменационной сессии загружайте список сдавших через массовые выдачи со сроком окончания через два года. Каждый получает письмо со ссылкой на верификацию, PDF-сертификатом и кнопкой Add to LinkedIn.
- Проверяйте ежемесячно. Первого числа выгружайте список awards, сортируйте по «Valid To» и отбирайте всех, у кого срок истекает в ближайшие 90 дней.
- Приглашайте продлить. Отправляйте этим людям ссылку на экзамен по пересертификации из вашего обычного почтового инструмента.
- Выдайте продление. Когда человек сдаёт, выдайте новую выдачу того же значка с новым сроком в два года. Старая сама отобразится как истёкшая; ничего с ней делать не нужно.
- Отвечайте аудиторам ссылкой. Когда комплаенс спрашивает, сертифицирован ли человек сейчас, вы отправляете URL верификации. Он показывает актуальный статус, и вам ничего не нужно проверять.
Никакого самописного ПО, cron-заданий, миграций. В этом и суть: управление жизненным циклом — это в основном выбор разумных дат и ежемесячная привычка.
Типичные ошибки
- Срок на всём подряд. Оставьте его для credentials, смысл которых действительно устаревает. Иначе вы создаёте работу по продлению без пользы.
- Путаница между истечением и отзывом. Отзыв истёкших credentials уничтожает историю непрерывной сертификации и создаёт впечатление, что человек никогда не был действителен.
- Забытый часовой пояс. Выбранная дата становится моментом времени. Если норма гласит «действительно до конца марта», установите срок на последний день марта или первый день апреля — в зависимости от трактовки вашей политики — и будьте последовательны.
- Расчёт на правку вместо повторной выдачи. Редактирование доступно только до отправки credential по email. Планируйте продления как новые выдачи с самого начала.
- Нет процесса напоминаний. Поскольку уведомления об истечении не автоматизированы, привычка должна быть вашей. Поставьте ежемесячную выгрузку в чей-нибудь календарь.
Что почитать дальше
Если ваши credentials будут проверять другие системы, стоит узнать, как устроен документ, несущий expires: разбор примера Open Badge JSON-LD проходит по каждому полю assertion. А если вы решаете, продолжать ли платить платформе за каждый credential, сравнение альтернатив Credly показывает расходы.
Готовы выдать свой первый верифицируемый credential? Начните бесплатно на 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 для буткемпов по программированию: проверяемые credentials в масштабе потока19 нояб. 2026 г. · 10мин чтения
- Настройка вебхуков для событий бейджей: интеграция с вашим бэкендом в реальном времени16 нояб. 2026 г. · 8мин чтения
- Open Badge Baking: как JSON оказывается внутри PNG9 нояб. 2026 г. · 10мин чтения


