Како опозвати 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>) или Cognito Bearer токена. ID награде иде у путању; 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"и листом ID-јева награда; враћа ID посла који можете пратити. Пун списак параметара налази се у API референци за awards.
API вам треба само када опозив покреће други систем. За појединачан случај контролна табла је бржа и има корак потврде који вас штити од погрешно укуцаног ID-ја.
Шта виде прималац и верификатор
Након опозива, ево шта се мења и колико брзо.
На јавној страници за верификацију. Страница на 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 да би приступ и евиденције пратили статус акредитива.
Често постављана питања
Могу ли да поништим опозив? Не кроз интерфејс. Ако сте опозвали грешком, издајте нови акредитив примаоцу. Опозвани остаје као део трага за ревизију.
Да ли прималац треба нешто да уради? Не. Ако сте одлучили да га обавестите, добија имејл. У супротном се промена дешава тихо на страници за верификацију.
Да ли опозив ради за акредитиве који никада нису послати? Да, мада за непослат акредитив са једноставном грешком можда радије желите да га измените пре слања или да га обришете ако га нико није видео.
Постоји ли ограничење колико могу да опозовем? Масовни опозив ради као наставив позадински посао, па се велике серије обрађују једном операцијом уместо једну по једну.
Хоће ли послодавци видети да је акредитив опозван? Свако ко га верификује преко јавног URL-а или тврдње види статус опозива и разлог, ако сте га дали.
Закључак
Опозив Open Badge-а је мала радња са великим последицама по поверење. Радите га са контролне табле када је реч о једном акредитиву, користите масовни опозив за кохорту, а API или webhooks када одлуку носи други систем. Држите разлоге неутралним, обавестите људе који треба да знају и запамтите да опозив мења оно што виде верификатори, а не фајлове који су већ у рукама прималаца.
Спремни да издате свој први проверљиви акредитив? Започните бесплатно на 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мин читања


