Kā atsaukt Open Badge (un kas notiek ar saņēmēja kopiju)
Atsaukšana Open Badges: kā tā darbojas, kas mainās saņēmējam un kā pareizi rīkoties situācijās „izsniegts kļūdas dēļ“, „akreditācija beigusies“ un „noteikumu pārkāpums“.
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.
Agrāk vai vēlāk katrai programmai, kas izsniedz digitālās akreditācijas, kāda no tām ir jāatsauc. Sertifikāts nonāca pie nepareizā cilvēka. Atklājās, ka izglītojamais krāpās noslēguma vērtēšanā. Partnera līgums beidzās, un nozīmēm ar uzrakstu „Certified Partner“ vairs nevajadzētu būt spēkā. Izsniegšana ir vieglā daļa; atsaukšana ir tā, kas izšķir, vai jūsu akreditācijām var patiešām uzticēties.
Šis ceļvedis izskaidro, kā atsaukšana darbojas Open Badges, ko saņēmējs pēc tam redz un ko neredz, un kā atsaukt vienu akreditāciju vai vairākus simtus vietnē https://badges.ninja, no informācijas paneļa vai caur API.
Ko Open Badges nozīmē „atsaukt“
Open Badges v2.0 specifikācijā katra izsniegtā nozīme ir apliecinājums (assertion): neliels JSON-LD dokuments publiskā URL, kas saka: „šis izdevējs šo nozīmi piešķīra šim saņēmējam šajā datumā.“ Atsaukšana ir vienkārši šī mitinātā dokumenta izmaiņa. Apliecinājumam tiek pievienots "revoked": true un pēc izvēles virkne "revocationReason", kas paskaidro iemeslu.
Šim risinājumam ir svarīga sekas, kas daudziem programmu īpašniekiem nāk kā pārsteigums:
- Mitinātais apliecinājums ir patiesības avots. Ikviens, kas akreditāciju verificē, ielādējot apliecinājuma URL vai atverot verifikācijas lapu, nekavējoties redz atsaukto stāvokli.
- Kopijas netiek atsauktas. Ja saņēmējs lejupielādēja nozīmes attēlu vai JSON, vai piespraudis to portfolio, šis fails nemainās. Tajā joprojām ir saite uz jūsu mitināto apliecinājumu, tāpēc verificētājs, kas tai seko, redzēs, ka tas atsaukts, bet cilvēks, kas uzmet aci saglabātam PNG, to neredzēs.
Tādējādi atsaukšana ir paziņojums verifikācijas galapunktā, nevis dzēšana. Iztēlojieties to kā zīmogu „VOID“ uz oriģinālā ieraksta, nevis kā katras fotokopijas vajāšanu.
Ja vēlaties dokumentu aplūkot tuvāk, mūsu Open Badge JSON-LD apskats iziet cauri katram laukam.
Atsaukt, izsniegt atkārtoti vai dzēst: izvēlieties pareizo darbību
Pirms ko klikšķināt, izlemiet, kura no trim darbībām atbilst situācijai. Tās nav savstarpēji aizvietojamas.
| Situācija | Labākā darbība | Kāpēc |
|---|---|---|
| Akreditācija izsniegta nepareizam cilvēkam vai ar drukas kļūdu | Dzēst (ja nav nosūtīta) vai atsaukt un izsniegt atkārtoti | Dzēšana ierakstu noņem pilnībā; atsaukšana saglabā audita pēdas |
| Izglītojamais pārkāpa noteikumus vai akreditācija iegūta negodīgi | Atsaukt ar iemeslu | Ieraksts paliek verificējams kā atsaukts, kas strīda gadījumā ir tieši tas, kas vajadzīgs |
| Akreditācijai vienkārši pienāca beigu datums | Nedarīt neko; izsniedzot iestatiet derīguma termiņu | Termiņa beigas ir parasts dzīves cikla notikums, nevis atsaukšana |
| Programma atcelta, kohorta anulēta | Masveida atsaukšana | Viens darbs, viens iemesls, piemērots visiem |
| Dati bija nepareizi, bet akreditācija citādi ir derīga | Labot pirms nosūtīšanas vai atsaukt un izsniegt atkārtoti pēc nosūtīšanas | Saglabā saņēmēja pieredzi tīru |
Divi praktiski noteikumi:
- Visam reālajam dodiet priekšroku atsaukšanai pār dzēšanu. Dzēstas akreditācijas publiskā lapa atgriež kļūdu „nav atrasts“. Atsaukta lapa joprojām atveras un skaidri norāda, ka tā ir atsaukta, kas ir daudz labāks pierādījums, ja kāds vēlāk jautā, kas notika.
- Nekad neizmantojiet atsaukšanu termiņa beigu vietā. Ja akreditācija ir derīga tikai divus gadus, izsniedzot iestatiet derīguma termiņu. Nozīme, kas klusi zaudē spēku, atšķiras no atsauktas, un jūsu verifikācijas lapai jānorāda, kura no tām tā ir.
Atsaukšana no informācijas paneļa
Dažām akreditācijām informācijas panelis ir ātrākais ceļš, un kods nav vajadzīgs.
- Pierakstieties un sānjoslā atveriet Awards.
- Atrodiet akreditāciju. Saraksts rāda saņēmēju, nozīmes nosaukumu, izsniegšanas datumu un derīguma termiņu, un meklēt var pēc saņēmēja.
- Noklikšķiniet uz rindas (vai View), lai atvērtu akreditācijas detaļu logu.
- Noklikšķiniet uz Revoke.
- Apstiprinājuma dialogā pēc izvēles ievadiet iemeslu un pēc izvēles atzīmējiet Email the recipient that their credential was revoked.
- Apstipriniet.

Akreditācija paliek jūsu sarakstā ar sarkanu Revoked zīmi blakus saņēmējam, lai jūs un jūsu komanda vienmēr redzētu, kas atsaukts. Atsaukšana akreditāciju neatmaksā jūsu plāna kvotā. Jūs to izsniedzāt, tā tika ieskaitīta.
Piezīme par iemesla lauku
Iemesls nav obligāts, bet aizpildiet to. Tas tiek saglabāts kopā ar akreditāciju, publiskajā Open Badges apliecinājumā parādās kā revocationReason un ir iekļauts webhook datos, ko saņem jūsu sistēmas. Tā kā tas ir publisks apliecinājumā, rakstiet to tā, kā rakstītu ārējam lasītājam. „Izsniegts kļūdas dēļ“ vai „Programma atcelta“ ir kārtībā. „Jāne krāpās 14. jautājumā“ nav. Personiskās detaļas glabājiet savos ierakstos, bet publisko iemeslu saglabājiet neitrālu.
Vai sūtīt saņēmējam e-pastu?
Parasti jā. Izglītojamajam, kas par savas akreditācijas anulēšanu uzzina tikai tad, kad darba devējs noklikšķina verifikācijas saiti, ir pilnas tiesības uz jums būt neapmierinātam. Paziņojums ir pēc izvēles tieši tāpēc, ka dažas atsaukšanas (piemēram, testa piešķīrumu masveida tīrīšana) nevienu nedrīkst traucēt. Mūsu ieteikums:
- Sūtiet e-pastu, kad atsaukšana skar reālu cilvēku, kas akreditāciju varētu joprojām rādīt.
- Nesūtiet e-pastu, kad sakārtojat iekšējos testa datus vai anulējat akreditācijas, kas nekad nav nosūtītas.
Daudzu akreditāciju atsaukšana vienlaikus
Programmām reti vajag atsaukt vienu akreditāciju atsevišķi; biežāk tā ir vesela kohorta. Sarakstā Awards:
- Atzīmējiet izvēles rūtiņas akreditācijām, ko vēlaties atsaukt.
- Masveida darbību joslā noklikšķiniet uz Revoke selected.
- Pievienojiet iemeslu un izlemiet, vai paziņot saņēmējiem, tad apstipriniet.
Masveida atsaukšana darbojas kā izturīgs fona darbs, tāpēc vairāki simti akreditāciju nebeigsies ar taimautu jūsu pārlūka cilnē. Jau atsauktas akreditācijas tiek izlaistas, nevis lauž partiju, un daļēji pārtrauktu darbu var turpināt. Tas pats mehānisms nodrošina masveida izsniegšanu no izklājlapas, ko aplūkojam rakstā kā izsniegt Open Badges no CSV.
Atsaukšana caur API
Ja jūsu mācību sistēma vai HR platforma izlemj, kurš vairs nav sertificēts, varat atsaukt programmatiski. Galapunkts ir POST /awards/{awardId}/revoke, autentificēts ar API atslēgu (X-Api-Key: bws_<32-hex>) vai Cognito Bearer pilnvaru. Award ID iet ceļā; reason un notify iet JSON pamatā, un abi ir neobligāti.
Izmantojot 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
Un 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
Daži praktiski sīkumi:
- Tas ir idempotents. Jau atsauktas akreditācijas atsaukšana atgriež to pašu veiksmīgo atbildi un nesūta otru paziņojumu. Tāpēc to var droši izsaukt no darba ar atkārtotiem mēģinājumiem.
- Iemesli tiek saīsināti līdz 500 rakstzīmēm.
notifypēc noklusējuma ir false. E-pasts netiek sūtīts, ja to neprasāt.- Masveida atsaukšana ir pieejama caur masveida galapunktu ar
action: "revoke"un award ID sarakstu; tā atgriež darba ID, ko varat izsekot. Visi parametri ir awards API atsaucē.
API vajadzīgs tikai tad, ja atsaukšanu vada cita sistēma. Vienreizējai darbībai informācijas panelis ir ātrāks un tam ir apstiprināšanas solis, kas pasargā no kļūdaini ievadīta ID.
Ko redz saņēmējs un verificētājs
Pēc atsaukšanas mainās šādi, un tik ātri.
Publiskajā verifikācijas lapā. Lapa vietnē https://badges.ninja/awards/<award-id> rāda akreditāciju kā atsauktu, un lapas virsrakstam kopīgošanai sociālajos tīklos tiek pievienots prefikss „[Revoked]“, lai kopīgota saite priekšskatījuma kartītē neizskatītos pēc spēkā esošas akreditācijas.
Open Badges v2.0 apliecinājumā. Mitinātais JSON vietnē https://api.badges.ninja/certify-badge/award/<award-id> tagad satur "revoked": true, kā arī "revocationReason", ja to norādījāt. Atsauktie apliecinājumi tiek kešoti tikai apmēram 30 sekundes, bet spēkā esošie piecas minūtes, tāpēc izmaiņas verificētājus sasniedz ātri.
Open Badges 3.0 akreditācijā. Atsaukšana arī pārslēdz akreditācijas bitu W3C Bitstring Status List, pēc kā to atpazīst verificējamo akreditāciju maki un verificētāji. Šis saraksts tiek kešots īslaicīgi, tāpēc gaidiet izplatīšanos apmēram minūtes laikā. Ja izvērtējat abas versijas, skatiet Open Badges v2 pret v3.
Saņēmēja paša kopijā. Lejupielādētajā failā nekas nemainās. Nozīmes attēls viņa klēpjdatorā izskatās tāpat. Mainās verifikācijas rezultāts: ikviens, kas noklikšķina uz saites vai akreditāciju pārbauda programmatiski, saņem atbildi „atsaukts“. Ja viņu informējāt, viņam ir arī e-pasts ar paskaidrojumu.
LinkedIn. LinkedIn profilam pievienota akreditācija ir saite ar metadatiem, kas norāda atpakaļ uz jūsu verifikācijas lapu. LinkedIn jūsu vietā neuzrauga atsaukšanu, tāpēc ieraksts profilā var palikt, taču ikviens, kas seko saitei, nonāk atsauktajā lapā. Tas ir vēl viens iemesls nosūtīt paziņojumu un lūgt saņēmēju ierakstu noņemt.
Informējiet savas sistēmas: webhook
Atsaukšana jūsu organizācijā reti ir stāsta beigas. Izglītojamajam var būt jāzaudē piekļuve kopienai, jāatjaunina darba devēja ieraksts vai jānoņem CRM birka. Badges Ninja, atsaucot akreditāciju, izsūta webhook notikumu credential.revoked ar award URL un iemeslu:
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Abonējiet to, un jūsu pakārtotās sistēmas paliek sinhronas, un nevienam nav jāatceras tās atjaunināt. Iestatīšanas detaļas ir webhook dokumentācijā, bet plašāko notikumu modeli aplūkojam rakstā webhook iestatīšana nozīmju notikumiem.
Vienkārša atsaukšanas politika, ko varat pieņemt jau šodien
Rīki ir vieglā puse. Grūtākā puse ir iepriekš izlemt, kad atsauksiet un kam to drīkst darīt. Īsa rakstiska politika novērš vēlākus strīdus. Strādājošs paraugs:
- Atsaukšanas pamati. Uzskaitiet tos: izsniegts kļūdas dēļ, iegūts ar pārkāpumu, prasība vairs nav izpildīta (piemēram, dalība beigusies) vai programma izbeigta.
- Kas lemj. Nosauciet lomu, nevis personu. Atsaukšanas tiesības ierobežojiet ar šo lomu.
- Paziņojums. Norādiet, ka saņēmēji tiek informēti pa e-pastu ar iemeslu, ja vien akreditācija nekad netika piegādāta.
- Apelācija. Dodiet saņēmējiem iespēju lēmumu apstrīdēt un norādiet, cik ilgi atbildēsiet. Ja apelācija ir veiksmīga, izsniedziet jaunu akreditāciju, nevis mēģiniet atsaukšanu atcelt, un vēsture paliek tīra.
- Ieraksts. Glabājiet iekšēju piezīmi par to, kurš ko un kāpēc atsauca, atsevišķi no neitrālā publiskā iemesla.
Publicējiet politiku tajā pašā lapā, kur aprakstāt akreditāciju, lai ieguvēji noteikumus zinātu pirms pieteikšanās.
Biežākās kļūdas, no kurām izvairīties
- Dzēšana, kad domājāt atsaukt. Dzēšana ir neatgriezeniska, un publiskā lapa pazūd. Izmantojiet to īstām kļūdām akreditācijām, ko neviens nav redzējis.
- Privātas detaļas iemeslā. Tas ir publisks apliecinājumā.
- Cerības, ka saglabātās kopijas mainīsies. Atsaukšana dzīvo verifikācijas galapunktā. Lūdziet saņēmējiem akreditāciju noņemt no profiliem un portfolio.
- Atsaukšana termiņa beigu vietā. Laikā ierobežotām akreditācijām izmantojiet derīguma termiņu.
- Pieņēmums par atmaksu. Atsauktas akreditācijas joprojām skaitās jūsu plāna kvotā.
- Pakārtoto sistēmu aizmiršana. Pieslēdziet webhook, lai piekļuve un ieraksti sekotu akreditācijas statusam.
Biežāk uzdotie jautājumi
Vai atsaukšanu var atcelt? Ne caur saskarni. Ja atsaucāt kļūdaini, izsniedziet saņēmējam jaunu akreditāciju. Atsauktā paliek audita pēdu daļa.
Vai saņēmējam kaut kas jādara? Nē. Ja izvēlējāties viņu informēt, viņš saņem e-pastu. Citādi izmaiņas klusi notiek verifikācijas lapā.
Vai atsaukšana darbojas akreditācijām, kas nav nosūtītas? Jā, lai gan nenosūtītai akreditācijai ar vienkāršu kļūdu varat dot priekšroku labošanai pirms nosūtīšanas vai dzēšanai, ja to neviens nav redzējis.
Vai atsaucamo skaitam ir ierobežojums? Masveida atsaukšana darbojas kā atsākams fona darbs, tāpēc lielas partijas tiek apstrādātas vienā operācijā, nevis pa vienai.
Vai darba devēji redzēs, ka akreditācija atsaukta? Ikviens, kas to verificē caur publisko URL vai apliecinājumu, redz atsaukšanas statusu un iemeslu, ja to norādījāt.
Secinājums
Open Badge atsaukšana ir neliela darbība ar reālām sekām uzticībai. Vienai akreditācijai to darāt no informācijas paneļa, kohortai izmantojiet masveida atsaukšanu, bet API vai webhook izmantojiet, kad lēmumu pieņem cita sistēma. Saglabājiet iemeslus neitrālus, informējiet tos, kam jāzina, un atcerieties: atsaukšana maina to, ko redz verificētāji, nevis failus, kas jau ir saņēmēju rokās.
Gatavi izsniegt savu pirmo verificējamo akreditāciju? Sāciet bez maksas vietnē badges.ninja — vizuālais dizainers, publiska verifikācijas lapa, PDF sertifikāts, Open Badge v2.0 izvade. Kredītkarte nav vajadzīga.
Kā šis raksts tika izveidots
Daži šī bloga raksti tiek sagatavoti ar MI asistenta palīdzību un pēc tam pārskatīti, faktu pārbaudīti un rediģēti Badges Ninja komandas pirms publicēšanas. Katrs koda paraugs un cena tiek pārbaudīti, salīdzinot ar aktuālo produktu. Vairāk par mūsu redakcionālo un MI procesu lasiet mūsu redakcionālā procesa lapā .

Par autoru
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.
Vairāk no Nacho Coll
- Programmēšanas bootcampu Open Badges: verificējamu apliecību izsniegšana visas kohortas mērogā2026. g. 19. nov. · 9min lasīšanai
- Webhook iestatīšana nozīmīšu notikumiem: reāllaika integrācija ar jūsu aizmugursistēmu2026. g. 16. nov. · 8min lasīšanai
- Open Badge derīguma termiņš un atjaunošana: laikā ierobežotu kvalifikāciju dzīves cikla pārvaldība2026. g. 12. nov. · 10min lasīšanai


