Як відкликати Open Badge (і що станеться з копією отримувача)
Відкликання в 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.
Рано чи пізно кожна програма, що видає цифрові посвідчення, має щось відкликати. Сертифікат потрапив не до тієї людини. Виявилося, що слухач списував на фінальному оцінюванні. Контракт із партнером завершився, і значки з написом «Certified Partner» більше не мають бути дійсними. Видача — це щасливий сценарій; відкликання вирішує, чи можна справді довіряти вашим посвідченням.
Цей посібник пояснює, як працює відкликання в Open Badges, що отримувач бачить і чого не бачить після цього, а також як відкликати одне посвідчення чи кілька сотень на https://badges.ninja — з панелі керування або через API.
Що означає «відкликати» в Open Badges
У специфікації Open Badges v2.0 кожен виданий значок — це assertion: невеликий документ JSON-LD, розміщений за публічним URL, який стверджує: «цей емітент нагородив цього отримувача цим значком цієї дати». Відкликання — це просто зміна цього розміщеного документа. Assertion отримує "revoked": true, а за бажанням і рядок "revocationReason" з поясненням причини.
Такий дизайн має важливий наслідок, який дивує багатьох власників програм:
- Розміщений assertion — джерело істини. Кожен, хто верифікує посвідчення, завантажуючи URL assertion або відкриваючи сторінку верифікації, одразу бачить стан «відкликано».
- Копії не відкликаються. Якщо отримувач завантажив зображення значка чи JSON або закріпив його в портфоліо, цей файл не змінюється. Він і далі містить посилання на ваш розміщений assertion, тож верифікатор, який перейде за ним, побачить відкликання, а людина, яка просто дивиться на збережений PNG, — ні.
Тож відкликання — це заява, зроблена на кінцевій точці верифікації, а не видалення. Уявіть, що ви ставите штамп «НЕДІЙСНЕ» на головному записі, а не ганяєтеся за кожною фотокопією.
Якщо хочете докладніше розглянути сам документ, наш розбір Open Badge JSON-LD проходить по кожному полю.
Відкликати, видати повторно чи видалити: оберіть правильну дію
Перш ніж щось натискати, визначте, яка з трьох дій підходить до ситуації. Вони не взаємозамінні.
| Ситуація | Найкраща дія | Чому |
|---|---|---|
| Посвідчення видано не тій особі або з помилкою в написанні | Видалити (якщо не надсилалося) або відкликати, а потім видати повторно | Видалення стирає запис повністю; відкликання зберігає слід аудиту |
| Слухач порушив правила або посвідчення отримано неналежним чином | Відкликати із зазначенням причини | Запис залишається верифікованим як відкликаний, а саме це вам потрібно під час спору |
| Посвідчення просто досягло кінцевої дати | Нічого не робити; задайте термін дії під час видачі | Завершення терміну — звичайна подія життєвого циклу, а не відкликання |
| Програму скасовано, когорту анульовано | Масове відкликання | Одне завдання, одна причина, застосована до всіх |
| Дані були хибними, але в іншому посвідчення дійсне | Редагувати перед надсиланням або відкликати й видати повторно після надсилання | Зберігає комфорт для отримувача |
Два правила на практиці:
- Для всього реального віддавайте перевагу відкликанню, а не видаленню. Публічна сторінка видаленого посвідчення повертає помилку «не знайдено». Відкликане і далі відкривається та чітко повідомляє, що відкликане, — це значно кращий доказ, якщо хтось пізніше запитає, що сталося.
- Ніколи не використовуйте відкликання замість завершення терміну дії. Якщо посвідчення дійсне лише два роки, задайте дату завершення під час видачі. Значок, що тихо втратив чинність, відрізняється від відкликаного, і ваша сторінка верифікації має показувати, який саме випадок.
Відкликання з панелі керування
Для кількох посвідчень панель — найшвидший шлях, і код не потрібен.
- Увійдіть і відкрийте Awards на бічній панелі.
- Знайдіть посвідчення. Список показує отримувача, назву значка, дату видачі та завершення, а шукати можна за отримувачем.
- Клацніть рядок (або View), щоб відкрити модальне вікно з деталями посвідчення.
- Натисніть Revoke.
- У діалозі підтвердження за бажанням введіть причину та за бажанням позначте Email the recipient that their credential was revoked.
- Підтвердьте.

Посвідчення залишається у вашому списку з червоною позначкою Revoked поруч з отримувачем, тож ви й ваша команда завжди бачите, що було відкликано. Відкликання не повертає посвідчення до квоти вашого плану. Ви його видали — воно враховане.
Примітка щодо поля причини
Причина необов’язкова, але заповніть її. Вона зберігається разом із посвідченням, з’являється як revocationReason у публічному assertion Open Badges і включається в payload вебхука, який отримують ваші системи. Оскільки вона публічна в assertion, пишіть її так, як для стороннього читача. «Issued in error» або «Program cancelled» — добре. «Джейн списувала на питанні 14» — ні. Особисті подробиці тримайте у власних записах, а публічну причину робіть нейтральною.
Чи надсилати отримувачу лист?
Зазвичай так. Слухач, який дізнається, що його посвідчення недійсне, лише коли роботодавець натисне посилання верифікації, має повне право бути вами незадоволеним. Сповіщення є опційним саме тому, що деякі відкликання (наприклад, масове прибирання тестових нагород) не потребують нікого турбувати. Наша порада:
- Надсилайте лист, коли відкликання стосується реальної людини, яка ще може демонструвати це посвідчення.
- Пропустіть лист, коли ви наводите лад у внутрішніх тестових даних або анулюєте посвідчення, які ніколи не надсилалися.
Відкликання багатьох посвідчень одночасно
Програмам рідко потрібно відкликати одне посвідчення ізольовано; частіше йдеться про цілу когорту. У списку Awards:
- Позначте прапорцями посвідчення, які хочете відкликати.
- Натисніть Revoke selected на панелі масових дій.
- Додайте причину, вирішіть, чи сповіщати отримувачів, і підтвердьте.
Масове відкликання виконується як надійне фонове завдання, тож кілька сотень посвідчень не призведуть до тайм-ауту вкладки браузера. Посвідчення, які вже відкликані, пропускаються, а не провалюють пакет, і завдання, перерване на півдорозі, можна відновити. Той самий механізм забезпечує масову видачу з таблиці, про що ми розповідаємо в як видавати Open Badges із CSV.
Відкликання через API
Якщо ваша навчальна система чи HR-платформа вирішує, хто більше не сертифікований, ви можете відкликати програмно. Кінцева точка — POST /awards/{awardId}/revoke, автентифікація за допомогою API-ключа (X-Api-Key: bws_<32-hex>) або Bearer-токена Cognito. Ідентифікатор нагороди йде в шляху; reason і notify — у тілі JSON, обидва необов’язкові.
Через curl:
curl -X POST https://api.badges.ninja/awards/<award-id>/revoke \
-H "X-Api-Key: bws_YOUR_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{"reason":"Issued to the wrong recipient","notify":true}'
# 200 -> {"revoked":true,"awardId":"<award-id>"}
У JavaScript:
const res = await fetch(`https://api.badges.ninja/awards/${awardId}/revoke`, {
method: "POST",
headers: { "X-Api-Key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({ reason: "Program cancelled", notify: false }),
});
const { revoked } = await res.json(); // true
А в Python:
import requests
res = requests.post(
f"https://api.badges.ninja/awards/{award_id}/revoke",
headers={"X-Api-Key": API_KEY},
json={"reason": "Program cancelled", "notify": False},
)
print(res.json()["revoked"]) # True
Кілька практичних деталей, які варто знати:
- Операція ідемпотентна. Відкликання вже відкликаного посвідчення повертає ту саму успішну відповідь і не надсилає другого сповіщення. Це робить безпечним виклик із завдання з повторними спробами.
- Причини обрізаються до 500 символів.
notifyза замовчуванням false. Нічого не надсилається поштою, доки ви про це не попросите.- Масове відкликання доступне через масову кінцеву точку з
action: "revoke"і списком ідентифікаторів нагород; воно повертає ідентифікатор завдання, яке можна відстежувати. Повні параметри — у довіднику API awards.
API потрібне лише тоді, коли відкликання ініціює інша система. Для разового випадку панель швидша й має крок підтвердження, що захищає від помилково введеного ідентифікатора.
Що бачать отримувач і верифікатор
Після відкликання змінюється таке, і ось як швидко.
На публічній сторінці верифікації. Сторінка за адресою https://badges.ninja/awards/<award-id> показує посвідчення як відкликане, а заголовок сторінки для поширення в соцмережах отримує префікс «[Revoked]», щоб поширене посилання не виглядало в картці попереднього перегляду як чинне посвідчення.
В assertion Open Badges v2.0. Розміщений JSON за адресою https://api.badges.ninja/certify-badge/award/<award-id> тепер містить "revoked": true, а також "revocationReason", якщо ви його вказали. Відкликані assertion кешуються лише близько 30 секунд, тоді як чинні — п’ять хвилин, тож зміна швидко доходить до верифікаторів.
У посвідченні Open Badges 3.0. Відкликання також перемикає біт посвідчення в W3C Bitstring Status List, за яким його виявляють гаманці та верифікатори verifiable credentials. Цей список кешується ненадовго, тож очікуйте поширення приблизно за хвилину. Якщо порівнюєте дві версії, дивіться Open Badges v2 vs v3.
У власній копії отримувача. У завантаженому файлі нічого не змінюється. Зображення значка на його ноутбуці виглядає так само. Змінюється результат верифікації: кожен, хто перейде за посиланням чи перевірить посвідчення програмно, отримує відповідь «відкликано». Якщо ви його сповістили, у нього також є лист із поясненням причини.
У LinkedIn. Посвідчення, додане до профілю LinkedIn, — це посилання плюс метадані, що вказують на вашу сторінку верифікації. LinkedIn не перевіряє відкликання за вас, тож запис може залишатися в профілі, але кожен, хто перейде за посиланням, потрапить на сторінку відкликання. Це ще одна причина надіслати сповіщення й попросити отримувача прибрати запис.
Повідомте власні системи: вебхуки
Відкликання рідко закінчує справу всередині вашої організації. Слухач може втратити доступ до спільноти, може знадобитися оновити запис роботодавця або прибрати тег у CRM. Badges Ninja надсилає подію вебхука credential.revoked, коли посвідчення відкликано, з URL нагороди та причиною:
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Підпишіться на неї, і ваші підпорядковані системи залишатимуться синхронізованими, і нікому не доведеться пам’ятати про ручні оновлення. Деталі налаштування — у документації вебхуків, а ширшу модель подій ми розглядаємо в налаштуванні вебхуків для подій значків.
Проста політика відкликання, яку можна ухвалити вже сьогодні
Інструменти — легка половина. Важча — наперед вирішити, коли ви відкликатимете і хто має на це право. Коротка письмова політика запобігає суперечкам потім. Робочий шаблон:
- Підстави для відкликання. Перелічіть їх: видано помилково, отримано через неправомірні дії, вимога більше не виконується (наприклад, членство припинилося) або програму скасовано.
- Хто вирішує. Назвіть роль, а не особу. Обмежте право відкликання цією роллю.
- Сповіщення. Зазначте, що отримувачів повідомляють листом із причиною, якщо посвідчення ніколи не було доставлене.
- Оскарження. Дайте отримувачам спосіб оскаржити рішення та вкажіть, скільки часу триватиме відповідь. Якщо оскарження успішне, видайте нове посвідчення, а не намагайтеся скасувати відкликання — так історія залишається чистою.
- Облік. Ведіть внутрішню нотатку про те, хто що відкликав і чому, окремо від нейтральної публічної причини.
Опублікуйте політику на тій самій сторінці, де описуєте посвідчення, щоб здобувачі знали правила до реєстрації.
Типові помилки, яких слід уникати
- Видалення замість відкликання. Видалення остаточне й незворотне, а публічна сторінка зникає. Використовуйте його для справжніх помилок у посвідченнях, яких ніхто не бачив.
- Приватні подробиці в причині. Вона публічна в assertion.
- Очікування, що збережені копії зміняться. Відкликання живе на кінцевій точці верифікації. Скажіть отримувачам прибрати посвідчення з профілів і портфоліо.
- Відкликання замість завершення терміну. Для обмежених у часі посвідчень використовуйте дату завершення.
- Припущення про повернення. Відкликані посвідчення й далі враховуються в квоті вашого плану.
- Забуті підпорядковані системи. Підключіть вебхук, щоб доступи й записи слідували за статусом посвідчення.
Часті запитання
Чи можна скасувати відкликання? Не через інтерфейс. Якщо ви відкликали помилково, видайте отримувачу нове посвідчення. Відкликане залишається частиною сліду аудиту.
Чи має отримувач щось робити? Ні. Якщо ви обрали сповіщення, він отримає лист. Інакше зміна відбувається тихо на сторінці верифікації.
Чи працює відкликання для посвідчень, які ніколи не надсилалися? Так, хоча для ненадісланого посвідчення з простою помилкою ви можете віддати перевагу редагуванню перед надсиланням або видаленню, якщо ніхто його не бачив.
Чи є ліміт на кількість відкликань? Масове відкликання виконується як відновлюване фонове завдання, тож великі пакети обробляються однією операцією, а не по одному.
Чи побачать роботодавці, що посвідчення відкликано? Кожен, хто верифікує його через публічний URL або assertion, бачить статус відкликання та причину, якщо ви її вказали.
Висновок
Відкликання Open Badge — невелика дія з реальними наслідками для довіри. Робіть це з панелі керування, коли йдеться про одне посвідчення, використовуйте масове відкликання для когорти й вдавайтеся до API чи вебхуків, коли рішення належить іншій системі. Пишіть нейтральні причини, сповіщайте тих, кому треба знати, і пам’ятайте: відкликання змінює те, що бачать верифікатори, а не файли, які вже в руках отримувачів.
Готові видати своє перше верифіковане посвідчення? Почніть безкоштовно на 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хв читання
- Строк дії та поновлення Open Badge: керування життєвим циклом обмежених у часі посвідчень12 лист. 2026 р. · 10хв читання


