Как да отнемете 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 документ, публикуван на публичен адрес, който казва „този издател е присъдил тази значка на този получател на тази дата“. Отнемането е просто промяна в този публикуван документ. Към твърдението се добавя "revoked": true и по желание низ "revocationReason", който обяснява причината.
Този дизайн има важно следствие, което изненадва много собственици на програми:
- Публикуваното твърдение е източникът на истината. Всеки, който проверява удостоверението, като отвори адреса на твърдението или страницата за верификация, веднага вижда състоянието „отнето“.
- Копията не се изтеглят обратно. Ако получателят е свалил изображението на значката или JSON файла, или го е закачил в портфолио, този файл не се променя. Той все още съдържа връзка към вашето публикувано твърдение, така че проверяващият, който последва връзката, ще види, че е отнето, но човек, който просто хвърли поглед на запазен PNG файл, няма да го разбере.
Затова отнемането е заявление, направено в точката за верификация, а не изтриване. Представете си го като печат „VOID“ върху главния запис, а не като гонене на всяко фотокопие.
Ако искате да разгледате по-отблизо самия документ, нашето ръководство за Open Badge JSON-LD преминава през всяко поле.
Отнемане, преиздаване или изтриване: изберете правилното действие
Преди да натиснете каквото и да е, решете кое от трите действия подхожда на ситуацията. Те не са взаимозаменяеми.
| Ситуация | Най-доброто действие | Защо |
|---|---|---|
| Удостоверението е издадено на грешен човек или с правописна грешка | Изтриване (ако не е изпращано) или отнемане, после преиздаване | Изтриването премахва записа напълно; отнемането запазва следа за одит |
| Обучаемият е нарушил правилата или удостоверението е получено неправомерно | Отнемане, с причина | Записът остава проверим като отнет, което искате при спор |
| Валидността на удостоверението просто е изтекла | Не правете нищо; задайте срок при издаване | Изтичането е нормален етап от жизнения цикъл, а не отнемане |
| Програмата е отменена, кохортата е анулирана | Масово отнемане | Една задача, една причина, приложена към всички |
| Данните са грешни, но иначе удостоверението е валидно | Редактиране преди изпращане или отнемане и преиздаване след изпращане | Запазва добро изживяване за получателя |
Две правила на палеца:
- Предпочитайте отнемането пред изтриването за всичко реално. Публичната страница на изтрито удостоверение връща грешка „не е намерено“. Отнетото все още се отваря и ясно казва, че е отнето, което е много по-добро доказателство, ако по-късно някой попита какво се е случило.
- Никога не използвайте отнемането вместо срок на валидност. Ако удостоверението е валидно само две години, задайте дата на изтичане при издаването. Значка, която тихо е изтекла, е нещо различно от такава, която е била оттеглена, и вашата страница за верификация трябва да казва кое от двете е.
Отнемане от таблото
За шепа удостоверения таблото е най-бързият път и не изисква код.
- Влезте и отворете Awards от страничната лента.
- Намерете удостоверението. Списъкът показва получателя, името на значката, датата на издаване и срока на валидност, а можете да търсите по получател.
- Щракнете върху реда (или View), за да отворите модалния прозорец с подробности.
- Щракнете Revoke.
- В диалога за потвърждение по желание въведете причина и по желание отбележете Email the recipient that their credential was revoked.
- Потвърдете.

Удостоверението остава във вашия списък с червен знак Revoked до получателя, така че вие и екипът ви винаги можете да видите какво е оттеглено. Отнемането не възстановява удостоверението към квотата на вашия план. Вие сте го издали, то се е отчело.
Бележка за полето „причина“
Причината е по избор, но я попълвайте. Тя се съхранява заедно с удостоверението, появява се като revocationReason в публичното твърдение на Open Badges и е включена в данните на webhook, които получават вашите системи. Тъй като е публична в твърдението, пишете я така, сякаш е за външен читател. „Издадено по грешка“ или „Програмата е отменена“ е наред. „Джейн преписва на въпрос 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]“, така че споделена връзка да не изглежда като действащо удостоверение в карта за преглед.
В твърдението на Open Badges v2.0. Публикуваният JSON на https://api.badges.ninja/certify-badge/award/<award-id> вече носи "revoked": true, плюс "revocationReason", ако сте дали причина. Отнетите твърдения се кешират само около 30 секунди, докато действащите се кешират пет минути, така че промяната стига бързо до проверяващите.
В удостоверението на Open Badges 3.0. Отнемането превключва и бита на удостоверението в W3C Bitstring Status List, чрез който портфейлите за проверими удостоверения и проверяващите го откриват. Този списък се кешира за кратко, така че очаквайте разпространение до около минута. Ако преценявате двете версии, вижте Open Badges v2 срещу v3.
В собственото копие на получателя. Нищо не се променя във файла, който е свалил. Изображението на значката на лаптопа му изглежда идентично. Променя се резултатът от верификацията: всеки, който последва връзката или провери удостоверението програмно, получава отговор „отнето“. Ако сте го уведомили, той има и имейл, който обяснява защо.
В LinkedIn. Удостоверение, добавено към профил в LinkedIn, е връзка плюс метаданни, които сочат към вашата страница за верификация. LinkedIn не проверява за отнемане от ваше име, така че записът може да остане в профила, но всеки, който последва връзката, попада на страницата за отнето удостоверение. Това е още една причина да изпратите известие и да помолите получателя да премахне записа.
Уведомете собствените си системи: webhooks
Отнемането рядко е краят на историята във вашата организация. Обучаемият може да трябва да загуби достъп до общност, може да се наложи да се обнови запис при работодател или да се премахне таг в CRM. Badges Ninja изпраща събитие webhook credential.revoked, когато удостоверение бъде отнето, с URL на наградата и причината:
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Абонирайте се за него и вашите системи надолу по веригата остават синхронизирани, без някой да трябва да помни да ги обнови. Подробности за настройката има в документацията за webhooks, а по-широкия модел на събитията описваме в настройка на webhook за събития на значки.
Проста политика за отнемане, която можете да приемете още днес
Инструментите са лесната половина. По-трудната е да решите предварително кога ще отнемате и кой има право да го прави. Кратка писмена политика предотвратява спорове по-късно. Работещ шаблон:
- Основания за отнемане. Изброете ги: издадено по грешка, получено чрез нарушение, изискването вече не е изпълнено (например членството е изтекло) или програмата е оттеглена.
- Кой решава. Назовете роля, не човек. Ограничете правото за отнемане до тази роля.
- Известие. Посочете, че получателите се уведомяват по имейл, с причината, освен ако удостоверението никога не е било доставено.
- Обжалване. Дайте на получателите начин да оспорят решението и кажете за колко време ще отговорите. Ако обжалването е успешно, преиздайте ново удостоверение, вместо да се опитвате да отмените отнемането, и историята остава чиста.
- Запис. Пазете вътрешна бележка кой какво е отнел и защо, отделно от неутралната публична причина.
Публикувайте политиката на същата страница, където описвате удостоверението, така че притежателите да знаят правилата, преди да се запишат.
Чести грешки, които да избягвате
- Изтриване, когато сте искали да отнемете. Изтриването е постоянно и не може да бъде отменено, а публичната страница изчезва. Използвайте го за истински грешки при удостоверения, които никой не е виждал.
- Лични подробности в причината. Тя е публична в твърдението.
- Очакване запазените копия да се променят. Отнемането живее в точката за верификация. Кажете на получателите да премахнат удостоверението от профили и портфолиа.
- Отнемане вместо изтичане на валидност. Използвайте дата на изтичане за удостоверения с ограничен срок.
- Предположение за възстановяване на средства. Отнетите удостоверения продължават да се броят към квотата на вашия план.
- Забравяне на системите надолу по веригата. Свържете webhook, за да следват достъпът и записите състоянието на удостоверението.
Често задавани въпроси
Мога ли да отменя отнемане? Не през интерфейса. Ако сте отнели по грешка, издайте ново удостоверение на получателя. Отнетото остава като част от следата за одит.
Трябва ли получателят да направи нещо? Не. Ако сте избрали да го уведомите, той получава имейл. В противен случай промяната става тихо на страницата за верификация.
Работи ли отнемането за удостоверения, които никога не са изпращани? Да, макар че при неизпратено удостоверение с проста грешка може да предпочетете да го редактирате преди изпращане или да го изтриете, ако никой не го е виждал.
Има ли ограничение колко мога да отнема? Масовото отнемане се изпълнява като възобновяема фонова задача, така че големи пакети се обработват с една операция, а не едно по едно.
Ще видят ли работодателите, че удостоверението е отнето? Всеки, който го проверява през публичния му адрес или твърдение, вижда статуса „отнето“ и причината, ако сте дали такава.
Заключение
Отнемането на Open Badge е малко действие с реални последици за доверието. Правете го от таблото, когато е едно удостоверение, използвайте масовото отнемане за кохорта и посягайте към API или webhooks, когато друга система владее решението. Пазете причините неутрални, уведомявайте хората, които трябва да знаят, и помнете, че отнемането променя това, което виждат проверяващите, а не файловете, които вече са в ръцете на получателите.
Готови ли сте да издадете първото си проверимо удостоверение? Започнете безплатно на 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мин четене
- Срок на валидност и подновяване на Open Badge: управление на жизнения цикъл на времево ограничени удостоверения12.11.2026 г. · 11мин четене


