Paano Mag-revoke ng Open Badge (At Ano ang Mangyayari sa Kopya ng Recipient)
Ang revocation sa Open Badges: paano ito gumagana, ano ang nagbabago para sa recipient, at ang tamang paraan ng paghawak sa «na-issue nang nagkamali» laban sa «nag-expire ang credential» laban sa «paglabag sa policy».
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.
Darating ang araw na kailangang bawiin ng bawat programang nag-iisyu ng digital credentials ang isa. Napunta ang certificate sa maling tao. May learner na nahuling nandaya sa final assessment. Natapos ang kontrata ng partner at ang mga badge na nagsasabing “Certified Partner” ay hindi na dapat valid. Ang pag-issue ang masayang bahagi; ang revocation ang bahaging magpapasya kung talagang mapagkakatiwalaan ang mga credentials mo.
Ipinapaliwanag ng gabay na ito kung paano gumagana ang revocation sa Open Badges, ano ang nakikita at hindi nakikita ng recipient pagkatapos, at paano mag-revoke ng isang credential o ilang daan sa https://badges.ninja, mula sa dashboard o sa API.
Ano ang ibig sabihin ng “revoke” sa Open Badges
Sa Open Badges v2.0 specification, bawat naka-issue na badge ay isang assertion: isang maliit na JSON-LD document na naka-host sa public URL na nagsasabing “ginawaran ng issuer na ito ang recipient na ito ng badge na ito sa petsang ito.” Ang revocation ay simpleng pagbabago sa naka-host na document na iyon. Nagkakaroon ang assertion ng "revoked": true, at opsyonal na "revocationReason" string na nagpapaliwanag kung bakit.
May mahalagang kahihinatnan ang disenyong ito na ikinagugulat ng maraming program owner:
- Ang naka-host na assertion ang source of truth. Ang sinumang mag-verify ng credential sa pamamagitan ng pag-fetch ng assertion URL o pagbukas ng verification page ay agad na makikita ang revoked na estado.
- Hindi binabawi ang mga kopya. Kung dinownload ng recipient ang badge image o ang JSON, o ni-pin ito sa portfolio, hindi nagbabago ang file na iyon. May link pa rin ito pabalik sa naka-host mong assertion, kaya makikita ng verifier na susunod sa link na revoked na ito, pero hindi ito makikita ng taong sumilip lang sa naka-save na PNG.
Kaya ang revocation ay isang pahayag sa verification endpoint, hindi pagbura. Isipin mo itong paglalagay ng “VOID” na tatak sa master record, sa halip na habulin ang bawat photocopy.
Kung gusto mong tingnan nang mas malapitan ang mismong document, dinadaanan ng Open Badge JSON-LD walkthrough namin ang bawat field.
Revoke, i-reissue, o i-delete: piliin ang tamang aksyon
Bago ka mag-click ng kahit ano, magpasya kung alin sa tatlong aksyon ang akma sa sitwasyon. Hindi sila mapagpapalit.
| Sitwasyon | Pinakamainam na aksyon | Bakit |
|---|---|---|
| Na-issue ang credential sa maling tao o may typo | I-delete (kung hindi pa naipadala) o I-revoke, tapos i-reissue | Buong inaalis ng delete ang record; pinapanatili ng revoke ang audit trail |
| Lumabag ang learner sa policy o hindi tama ang pagkakakuha ng credential | I-revoke, may reason | Nananatiling verifiable ang record bilang revoked, na siyang gusto mo sa isang dispute |
| Umabot lang sa end date ang credential | Walang gagawin; magtakda ng expiry kapag nag-issue | Normal na lifecycle event ang expiry, hindi revocation |
| Kinansela ang programa, na-void ang cohort | Bulk revoke | Isang job, isang reason, para sa lahat |
| Mali ang mga detalye pero valid pa rin ang credential | I-edit bago ipadala, o i-revoke at i-reissue pagkatapos maipadala | Pinananatiling malinis ang karanasan ng recipient |
Dalawang rule of thumb:
- Piliin ang revoke kaysa delete para sa anumang totoo. Ang public page ng na-delete na credential ay nagbabalik ng not-found error. Ang na-revoke ay nagre-resolve pa rin at malinaw na nagsasabing revoked ito, na mas mahusay na ebidensya kung may magtanong kalaunan kung ano ang nangyari.
- Huwag gamitin ang revocation bilang kapalit ng expiry. Kung dalawang taon lang valid ang credential, magtakda ng expiry date kapag nag-issue. Magkaiba ang badge na tahimik na nag-lapse at ang badge na binawi, at dapat sabihin ng verification page mo kung alin.
Pag-revoke mula sa dashboard
Para sa iilang credentials, ang dashboard ang pinakamabilis na daan at walang code na kailangan.
- Mag-sign in at buksan ang Awards mula sa sidebar.
- Hanapin ang credential. Ipinapakita ng listahan ang recipient, pangalan ng badge, petsa ng pag-issue at expiry, at puwede kang maghanap ayon sa recipient.
- I-click ang row (o View) para buksan ang credential detail modal.
- I-click ang Revoke.
- Sa confirmation dialog, opsyonal na maglagay ng reason, at opsyonal na lagyan ng tsek ang Email the recipient that their credential was revoked.
- Kumpirmahin.

Nananatili ang credential sa listahan mo na may pulang Revoked chip sa tabi ng recipient, kaya laging makikita mo at ng team mo kung ano ang binawi. Hindi ibinabalik ng revocation ang credential sa plan quota mo. Na-issue mo ito, nabilang na ito.
Paalala tungkol sa reason field
Opsyonal ang reason, pero punan mo ito. Naka-store ito kasama ng credential, lumalabas bilang revocationReason sa public Open Badges assertion, at kasama sa webhook payload na natatanggap ng mga system mo. Dahil public ito sa assertion, isulat mo ito na parang para sa outside reader. Okay ang “Issued in error” o “Program cancelled”. Hindi okay ang “Nandaya si Jane sa tanong 14.” Itago ang personal na detalye sa sarili mong mga record at panatilihing neutral ang public reason.
Dapat mo bang i-email ang recipient?
Karaniwan, oo. Ang learner na malalamang patay na ang credential niya kapag may employer na nag-click ng verification link ay may karapatang magalit sa iyo. Opsyonal ang notification dahil may ilang revocation (halimbawa, bulk clean-up ng test awards) na hindi kailangang mang-abala ng kahit sino. Ang payo namin:
- Mag-email kapag apektado ng revocation ang totoong tao na maaaring ipinapakita pa ang credential.
- Huwag mag-email kapag nililinis mo ang internal test data o ine-void ang mga credential na hindi pa naipapadala.
Pag-revoke ng maraming credentials nang sabay
Bihirang kailanganin ng mga programa na mag-revoke ng isang credential lang; mas madalas ay buong cohort. Sa Awards list:
- Lagyan ng tsek ang mga checkbox ng mga credential na gusto mong bawiin.
- I-click ang Revoke selected sa bulk-action bar.
- Magdagdag ng reason at magpasya kung aabisuhan ang mga recipient, tapos kumpirmahin.
Tumatakbo ang bulk revocation bilang durable background job, kaya hindi magti-time out ang browser tab mo kahit ilang daang credentials. Nilalaktawan ang mga credential na revoked na sa halip na mabigo ang batch, at puwedeng ipagpatuloy ang job na naputol sa gitna. Ang parehong makinarya ang nagpapagana sa bulk issuing mula sa spreadsheet, na tinalakay namin sa how to issue Open Badges from a CSV.
Pag-revoke gamit ang API
Kung ang learning system o HR platform mo ang nagpapasya kung sino ang hindi na certified, puwede kang mag-revoke nang programmatically. Ang endpoint ay POST /awards/{awardId}/revoke, na authenticated gamit ang API key (X-Api-Key: bws_<32-hex>) o Cognito Bearer token. Nasa path ang award ID; ang reason at notify ay nasa JSON body at pareho silang opsyonal.
Gamit ang 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>"}
Sa 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
At sa 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
Ilang praktikal na detalyeng dapat malaman:
- Idempotent ito. Ang pag-revoke ng credential na revoked na ay nagbabalik ng parehong success response at hindi nagpapadala ng pangalawang notification. Kaya ligtas itong tawagin mula sa job na nagre-retry.
- Pinuputol ang mga reason sa 500 characters.
- Naka-default sa false ang
notify. Walang ie-email maliban kung hihilingin mo. - Available ang bulk revoke sa pamamagitan ng bulk endpoint na may
action: "revoke"at listahan ng award IDs; nagbabalik ito ng job ID na puwede mong i-track. Nasa awards API reference ang buong parameters.
Kailangan mo lang ng API kapag ibang system ang nagtutulak ng revocation. Para sa isang beses lang, mas mabilis ang dashboard at may confirmation step na nagpoprotekta sa iyo laban sa maling na-type na ID.
Ano ang nakikita ng recipient at ng verifier
Pagkatapos mong mag-revoke, ito ang nagbabago, at kung gaano kabilis.
Sa public verification page. Ipinapakita ng page sa https://badges.ninja/awards/<award-id> na revoked ang credential, at may prefix na “[Revoked]” ang page title para sa social sharing para hindi magmukhang live na credential ang naibahaging link sa preview card.
Sa Open Badges v2.0 assertion. May "revoked": true na ngayon ang naka-host na JSON sa https://api.badges.ninja/certify-badge/award/<award-id>, kasama ang "revocationReason" kung nagbigay ka. Mga 30 segundo lang ang cache ng mga revoked assertion, samantalang limang minuto ang sa mga live, kaya mabilis na umaabot sa mga verifier ang pagbabago.
Sa Open Badges 3.0 credential. Binabago rin ng revocation ang bit ng credential sa isang W3C Bitstring Status List, na paraan ng mga verifiable-credential wallet at verifier para madetect ito. Saglit lang ang cache ng listahang iyon, kaya asahan ang propagation sa loob ng mga isang minuto. Kung tinitimbang mo ang dalawang bersyon, tingnan ang Open Badges v2 vs v3.
Sa mismong kopya ng recipient. Walang nagbabago sa file na dinownload nila. Pareho pa rin ang itsura ng badge image sa laptop nila. Ang nagbabago ay ang resulta ng verification: ang sinumang mag-click ng link o mag-check ng credential nang programmatically ay makakakuha ng revoked na sagot. Kung inabisuhan mo sila, may email din silang nagpapaliwanag kung bakit.
Sa LinkedIn. Ang credential na idinagdag sa LinkedIn profile ay link kasama ng metadata na tumuturo pabalik sa verification page mo. Hindi nagpo-poll ang LinkedIn para sa revocation para sa iyo, kaya maaaring manatili ang entry sa profile, pero ang sinumang susunod sa link ay mapupunta sa revoked page. Isa pa itong dahilan para magpadala ng notification at hilingin sa recipient na alisin ang entry.
Sabihan ang sarili mong mga system: webhooks
Bihirang dito nagtatapos ang kuwento sa loob ng organisasyon mo. Maaaring kailangang mawalan ng access ang learner sa isang community, maaaring kailangang i-update ang employer record, o maaaring kailangang alisin ang CRM tag. Nagpapadala ang Badges Ninja ng credential.revoked webhook event kapag na-revoke ang credential, kasama ang award URL at ang reason:
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Mag-subscribe dito at mananatiling magkakasabay ang mga downstream system mo nang hindi kailangang may magtandang mag-update. Nasa webhooks documentation ang setup details, at tinatalakay namin ang mas malawak na event model sa webhook setup for badge events.
Simpleng revocation policy na puwede mong gamitin ngayon
Ang mga tool ang madaling kalahati. Ang mas mahirap na kalahati ay ang pagpapasya nang maaga kung kailan ka magre-revoke at sino ang pinapayagan. Pinipigilan ng maikling nakasulat na policy ang mga pagtatalo sa hinaharap. Isang template na puwedeng gamitin:
- Mga batayan ng revocation. Ilista ang mga ito: na-issue nang nagkamali, nakuha sa pamamagitan ng misconduct, hindi na natutugunan ang requirement (halimbawa, nag-lapse ang membership), o binawi ang programa.
- Sino ang magpapasya. Magpangalan ng role, hindi ng tao. Limitahan ang revoke permission sa role na iyon.
- Abiso. Sabihing aabisuhan ang mga recipient sa pamamagitan ng email, kasama ang reason, maliban kung hindi pa naihahatid ang credential.
- Apela. Bigyan ang mga recipient ng paraan para kontrahin ang desisyon at sabihin kung gaano katagal ka sasagot. Kung magtagumpay ang apela, mag-reissue ng bagong credential sa halip na subukang i-undo ang revocation, at mananatiling malinis ang history.
- Record. Magtago ng internal na tala kung sino ang nag-revoke ng ano at bakit, hiwalay sa neutral na public reason.
I-publish ang policy sa parehong page kung saan mo inilalarawan ang credential, para alam ng mga earner ang mga patakaran bago sila mag-sign up.
Mga karaniwang pagkakamaling dapat iwasan
- Pag-delete kahit revoke ang ibig mong gawin. Permanente ang delete at hindi na maibabalik, at nawawala nito ang public page. Gamitin ito para sa tunay na pagkakamali sa mga credential na wala pang nakakakita.
- Paglalagay ng pribadong detalye sa reason. Public ito sa assertion.
- Pag-asang magbabago ang mga naka-save na kopya. Nasa verification endpoint ang revocation. Sabihan ang mga recipient na alisin ang credential sa mga profile at portfolio.
- Pag-revoke sa halip na expiry. Gumamit ng expiry date para sa mga credential na may takdang panahon.
- Pag-aakalang may refund. Nabibilang pa rin sa plan quota mo ang mga revoked na credential.
- Pagkalimot sa mga downstream system. I-wire up ang webhook para sumunod ang access at mga record sa status ng credential.
Mga madalas itanong
Puwede ko bang i-undo ang revocation? Hindi sa pamamagitan ng interface. Kung nagkamali ka ng revoke, mag-issue ng bagong credential sa recipient. Mananatili ang na-revoke bilang bahagi ng audit trail.
Kailangan bang may gawin ang recipient? Hindi. Kung pinili mong abisuhan sila, makakatanggap sila ng email. Kung hindi, tahimik na nangyayari ang pagbabago sa verification page.
Gumagana ba ang revocation sa mga credential na hindi pa naipapadala? Oo, bagaman para sa hindi pa naipapadalang credential na may simpleng pagkakamali, baka mas gusto mong i-edit ito bago ipadala, o i-delete kung wala pang nakakakita.
May limit ba kung ilan ang puwede kong i-revoke? Tumatakbo ang bulk revocation bilang resumable background job, kaya nahahawakan ang malalaking batch sa isang operasyon sa halip na isa-isa.
Makikita ba ng mga employer na na-revoke ang credential? Ang sinumang mag-verify nito sa pamamagitan ng public URL o assertion nito ay makikita ang revoked status at ang reason, kung nagbigay ka.
Konklusyon
Ang pag-revoke ng Open Badge ay maliit na aksyon na may tunay na epekto sa tiwala. Gawin ito sa dashboard kapag iisang credential, gamitin ang bulk revoke para sa cohort, at gamitin ang API o webhooks kapag ibang system ang may hawak ng desisyon. Panatilihing neutral ang mga reason, abisuhan ang mga taong kailangang makaalam, at tandaang binabago ng revocation ang nakikita ng mga verifier, hindi ang mga file na hawak na ng mga recipient.
Handa ka na bang mag-issue ng una mong verifiable credential? Magsimula nang libre sa badges.ninja — visual designer, public verification page, PDF certificate, Open Badge v2.0 output. Hindi kailangan ng credit card.
Paano ginawa ang artikulong ito
Ang ilang artikulo sa blog na ito ay ginagawa gamit ang tulong ng AI assistant, pagkatapos ay sinusuri, tinitiyak ang katumpakan, at ine-edit ng Badges Ninja team bago ilathala. Bawat code sample at presyo ay beripikado laban sa live na produkto. Alamin pa ang tungkol sa aming editorial at AI na proseso sa aming pahina ng editorial process .

Tungkol sa may-akda
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.
Higit pa mula kay Nacho Coll
- Open Badges para sa Coding Bootcamp: Mag-issue ng Verifiable Credentials sa Laki ng Buong CohortNob 19, 2026 · 12min basahin
- Pag-set Up ng Webhooks para sa Badge Events: Real-Time na Integration sa Iyong BackendNob 16, 2026 · 10min basahin
- Expiration at Renewal ng Open Badge: Lifecycle Management para sa mga Credentials na may Takdang PanahonNob 12, 2026 · 12min basahin


