Slik tilbakekaller du et Open Badge (og hva som skjer med mottakerens kopi)
Tilbakekalling i Open Badges: hvordan det fungerer, hva som endrer seg for mottakeren, og riktig måte å håndtere «utstedt ved en feil» kontra «legitimasjonen er utløpt» kontra «brudd på retningslinjer».
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.
Før eller siden må alle programmer som utsteder digitale legitimasjoner ta en tilbake. Et sertifikat gikk til feil person. En deltaker viste seg å ha jukset på avsluttende vurdering. En partneravtale tok slutt, og badgene som sa «Certified Partner» bør ikke lenger være gyldige. Utstedelse er den enkle delen; tilbakekalling er delen som avgjør om legitimasjonene dine faktisk kan stoles på.
Denne guiden forklarer hvordan tilbakekalling fungerer i Open Badges, hva mottakeren ser og ikke ser etterpå, og hvordan du tilbakekaller én legitimasjon eller flere hundre på https://badges.ninja, fra dashbordet eller via API-et.
Hva «tilbakekall» betyr i Open Badges
I Open Badges v2.0-spesifikasjonen er hvert utstedte badge en assertion: et lite JSON-LD-dokument som ligger på en offentlig URL og sier «denne utstederen tildelte dette badget til denne mottakeren på denne datoen.» Tilbakekalling er bare en endring i det hostede dokumentet. Assertionen får "revoked": true, og eventuelt en "revocationReason"-streng som forklarer hvorfor.
Den utformingen har en viktig konsekvens som overrasker mange programeiere:
- Den hostede assertionen er sannhetskilden. Alle som verifiserer legitimasjonen ved å hente assertion-URL-en eller åpne verifiseringssiden, ser den tilbakekalte statusen umiddelbart.
- Kopier kalles ikke tilbake. Hvis mottakeren har lastet ned badge-bildet eller JSON-filen, eller festet den i en portefølje, endres ikke den filen. Den inneholder fortsatt en lenke tilbake til den hostede assertionen din, så en verifiserer som følger lenken ser at den er tilbakekalt, men en person som bare ser på en lagret PNG, gjør ikke det.
Tilbakekalling er derfor en erklæring som avgis ved verifiseringsendepunktet, ikke en sletting. Tenk på det som å stemple «UGYLDIG» på hovedposten i stedet for å jage hver eneste fotokopi.
Hvis du vil se nærmere på selve dokumentet, går vår Open Badge JSON-LD-gjennomgang gjennom hvert felt.
Tilbakekall, utsted på nytt eller slett: velg riktig handling
Før du klikker på noe, må du avgjøre hvilken av tre handlinger som passer til situasjonen. De er ikke utbyttbare.
| Situasjon | Beste handling | Hvorfor |
|---|---|---|
| Legitimasjonen ble utstedt til feil person eller med en skrivefeil | Slett (hvis aldri sendt) eller Tilbakekall, og utsted deretter på nytt | Sletting fjerner posten helt; tilbakekalling beholder et revisjonsspor |
| Deltakeren brøt retningslinjer, eller legitimasjonen ble oppnådd på uriktig vis | Tilbakekall, med en begrunnelse | Posten forblir verifiserbar som tilbakekalt, noe du vil ha i en tvist |
| Legitimasjonen nådde bare sluttdatoen sin | Gjør ingenting; sett en utløpsdato når du utsteder | Utløp er en normal del av livssyklusen, ikke en tilbakekalling |
| Programmet avlyst, kullet ugyldiggjort | Masse-tilbakekalling | Én jobb, én begrunnelse, brukt på alle |
| Detaljene var feil, men legitimasjonen er ellers gyldig | Rediger før sending, eller tilbakekall og utsted på nytt etter sending | Holder mottakerens opplevelse ryddig |
To tommelfingerregler:
- Foretrekk tilbakekalling framfor sletting for alt som er ekte. Den offentlige siden til en slettet legitimasjon gir en feilmelding om at den ikke finnes. En tilbakekalt legitimasjon kan fortsatt åpnes og sier tydelig at den er tilbakekalt, noe som er langt bedre dokumentasjon hvis noen senere spør hva som skjedde.
- Bruk aldri tilbakekalling som erstatning for utløp. Hvis en legitimasjon bare er gyldig i to år, setter du en utløpsdato når du utsteder den. Et badge som stille utløper, er noe annet enn et som ble trukket tilbake, og verifiseringssiden din bør si hvilket av dem det er.
Tilbakekalling fra dashbordet
For en håndfull legitimasjoner er dashbordet den raskeste veien og krever ingen kode.
- Logg inn og åpne Awards i sidemenyen.
- Finn legitimasjonen. Listen viser mottaker, badge-navn, utstedelsesdato og utløp, og du kan søke etter mottaker.
- Klikk på raden (eller View) for å åpne detaljvinduet for legitimasjonen.
- Klikk på Revoke.
- I bekreftelsesdialogen kan du eventuelt skrive inn en begrunnelse, og eventuelt huke av for Email the recipient that their credential was revoked.
- Bekreft.

Legitimasjonen blir stående i listen din med en rød Revoked-merkelapp ved siden av mottakeren, slik at du og teamet ditt alltid kan se hva som er trukket tilbake. Tilbakekalling refunderer ikke legitimasjonen mot kvoten i planen din. Du utstedte den, så den telte med.
Et ord om begrunnelsesfeltet
Begrunnelsen er valgfri, men fyll den ut. Den lagres sammen med legitimasjonen, vises som revocationReason i den offentlige Open Badges-assertionen, og er med i webhook-payloaden som systemene dine mottar. Fordi den er offentlig på assertionen, bør du skrive den slik du ville skrevet til en utenforstående leser. «Utstedt ved en feil» eller «Program avlyst» er greit. «Jane jukset på spørsmål 14» er det ikke. Hold personlige detaljer i dine egne opptegnelser, og hold den offentlige begrunnelsen nøytral.
Bør du sende e-post til mottakeren?
Vanligvis ja. En deltaker som først oppdager at legitimasjonen er død når en arbeidsgiver klikker på verifiseringslenken, har all rett til å være misfornøyd med deg. Varslingen er frivillig nettopp fordi noen tilbakekallinger (for eksempel en masseopprydding av testawards) ikke trenger å bry noen. Vår anbefaling:
- Send e-post når tilbakekallingen berører en ekte person som kanskje fortsatt viser fram legitimasjonen.
- Hopp over e-posten når du rydder opp i interne testdata eller ugyldiggjør legitimasjoner som aldri ble sendt.
Tilbakekall mange legitimasjoner samtidig
Programmer trenger sjelden å tilbakekalle én legitimasjon isolert; oftere gjelder det et helt kull. I Awards-listen:
- Huk av for legitimasjonene du vil trekke tilbake.
- Klikk Revoke selected i handlingslinjen for massehandlinger.
- Legg til en begrunnelse, velg om mottakerne skal varsles, og bekreft.
Masse-tilbakekalling kjører som en robust bakgrunnsjobb, så noen hundre legitimasjoner får ikke nettleserfanen din til å tidsavbrytes. Legitimasjoner som allerede er tilbakekalt, hoppes over i stedet for å la hele batchen feile, og en jobb som ble avbrutt underveis, kan gjenopptas. Den samme mekanismen driver masseutstedelse fra et regneark, som vi tar for oss i slik utsteder du Open Badges fra en CSV.
Tilbakekalling via API-et
Hvis læringssystemet eller HR-plattformen din avgjør hvem som ikke lenger er sertifisert, kan du tilbakekalle programmatisk. Endepunktet er POST /awards/{awardId}/revoke, autentisert med en API-nøkkel (X-Api-Key: bws_<32-hex>) eller et Cognito Bearer-token. Award-ID-en står i stien; reason og notify står i JSON-bodyen, og begge er valgfrie.
Med 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>"}
I 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
Og i 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
Noen praktiske detaljer det er verdt å kjenne til:
- Den er idempotent. Å tilbakekalle en legitimasjon som allerede er tilbakekalt, gir samme suksessrespons og sender ikke en ny varsling. Det gjør det trygt å kalle fra en jobb som prøver på nytt.
- Begrunnelser avkortes til 500 tegn.
notifyer false som standard. Ingenting sendes på e-post med mindre du ber om det.- Masse-tilbakekalling er tilgjengelig via masse-endepunktet med
action: "revoke"og en liste med award-ID-er; det returnerer en jobb-ID du kan følge. De fullstendige parameterne finner du i awards API-referansen.
Du trenger bare API-et når tilbakekallingen styres av et annet system. For en enkeltsak er dashbordet raskere og har et bekreftelsessteg som beskytter deg mot en feiltastet ID.
Hva mottakeren og verifisereren ser
Etter at du har tilbakekalt, endres dette, og så raskt skjer det.
På den offentlige verifiseringssiden. Siden på https://badges.ninja/awards/<award-id> viser legitimasjonen som tilbakekalt, og sidetittelen for deling i sosiale medier får prefikset «[Revoked]», slik at en delt lenke ikke ser ut som en gyldig legitimasjon i et forhåndsvisningskort.
I Open Badges v2.0-assertionen. Den hostede JSON-en på https://api.badges.ninja/certify-badge/award/<award-id> har nå "revoked": true, pluss "revocationReason" hvis du oppga en. Tilbakekalte assertions caches bare i omtrent 30 sekunder, mens gyldige caches i fem minutter, så endringen når verifisererne raskt.
I Open Badges 3.0-legitimasjonen. Tilbakekalling snur også legitimasjonens bit i en W3C Bitstring Status List, som er måten lommebøker og verifisererne for verifiable credentials oppdager den på. Listen caches kort, så regn med at endringen spres innen omtrent ett minutt. Hvis du vurderer de to versjonene, kan du lese Open Badges v2 vs v3.
I mottakerens egen kopi. Ingenting endres i filen de lastet ned. Badge-bildet på laptopen deres ser identisk ut. Det som endres, er utfallet av verifiseringen: alle som klikker seg videre eller sjekker legitimasjonen programmatisk, får det tilbakekalte svaret. Hvis du varslet dem, har de også en e-post som forklarer hvorfor.
På LinkedIn. En legitimasjon som er lagt til på en LinkedIn-profil, er en lenke pluss metadata som peker tilbake til verifiseringssiden din. LinkedIn sjekker ikke for tilbakekalling på dine vegne, så oppføringen kan bli stående på profilen, men alle som følger lenken, havner på den tilbakekalte siden. Dette er enda en grunn til å sende varslingen og be mottakeren fjerne oppføringen.
Si fra til dine egne systemer: webhooks
Tilbakekalling er sjelden slutten på historien i organisasjonen din. Deltakeren kan trenge å miste tilgang til et fellesskap, en arbeidsgiverpost kan trenge oppdatering, eller en CRM-tagg kan måtte fjernes. Badges Ninja sender en credential.revoked-webhook-hendelse når en legitimasjon tilbakekalles, med award-URL-en og begrunnelsen:
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Abonner på den, så holder downstream-systemene dine følge uten at noen må huske å oppdatere dem. Oppsettdetaljer finner du i webhook-dokumentasjonen, og den bredere hendelsesmodellen tar vi for oss i webhook-oppsett for badge-hendelser.
En enkel tilbakekallingspolicy du kan ta i bruk i dag
Verktøy er den enkle halvdelen. Den vanskeligere halvdelen er å bestemme på forhånd når du skal tilbakekalle, og hvem som har lov til det. En kort skriftlig policy forhindrer krangel senere. En brukbar mal:
- Grunner til tilbakekalling. List dem opp: utstedt ved en feil, oppnådd gjennom uredelighet, krav ikke lenger oppfylt (for eksempel et utløpt medlemskap) eller program trukket tilbake.
- Hvem avgjør. Oppgi en rolle, ikke en person. Begrens tilbakekallingstilgangen til den rollen.
- Varsel. Oppgi at mottakerne får beskjed på e-post, med begrunnelsen, med mindre legitimasjonen aldri ble levert.
- Klage. Gi mottakerne en måte å bestride avgjørelsen på, og oppgi hvor lang tid du bruker på å svare. Hvis en klage får medhold, utsteder du en ny legitimasjon i stedet for å prøve å angre tilbakekallingen, så forblir historikken ren.
- Registrering. Før en intern notis om hvem som tilbakekalte hva og hvorfor, atskilt fra den nøytrale offentlige begrunnelsen.
Publiser policyen på den samme siden der du beskriver legitimasjonen, slik at deltakerne kjenner reglene før de melder seg på.
Vanlige feil du bør unngå
- Å slette når du mente å tilbakekalle. Sletting er permanent og kan ikke angres, og den får den offentlige siden til å forsvinne. Bruk den til ekte feil på legitimasjoner ingen har sett.
- Å legge private detaljer i begrunnelsen. Den er offentlig på assertionen.
- Å forvente at lagrede kopier endres. Tilbakekalling bor ved verifiseringsendepunktet. Be mottakerne fjerne legitimasjonen fra profiler og porteføljer.
- Å tilbakekalle i stedet for å la utløpe. Bruk en utløpsdato for tidsbegrensede legitimasjoner.
- Å anta en refusjon. Tilbakekalte legitimasjoner teller fortsatt mot kvoten i planen din.
- Å glemme downstream-systemer. Sett opp webhooken slik at tilgang og opptegnelser følger statusen til legitimasjonen.
Ofte stilte spørsmål
Kan jeg angre en tilbakekalling? Ikke via grensesnittet. Hvis du tilbakekalte ved en feil, utsteder du en ny legitimasjon til mottakeren. Den tilbakekalte blir stående som en del av revisjonssporet.
Må mottakeren gjøre noe? Nei. Hvis du valgte å varsle dem, får de en e-post. Ellers skjer endringen i det stille på verifiseringssiden.
Fungerer tilbakekalling for legitimasjoner som aldri ble sendt? Ja, men for en usendt legitimasjon med en enkel feil foretrekker du kanskje å redigere den før sending, eller slette den hvis ingen har sett den.
Er det en grense for hvor mange jeg kan tilbakekalle? Masse-tilbakekalling kjører som en gjenopptakbar bakgrunnsjobb, så store batcher håndteres i én operasjon i stedet for én etter én.
Vil arbeidsgivere se at en legitimasjon ble tilbakekalt? Alle som verifiserer den via den offentlige URL-en eller assertionen, ser den tilbakekalte statusen og begrunnelsen, hvis du oppga en.
Konklusjon
Å tilbakekalle et Open Badge er en liten handling med reelle konsekvenser for tilliten. Gjør det fra dashbordet når det gjelder én legitimasjon, bruk masse-tilbakekalling for et kull, og ta i bruk API-et eller webhooks når et annet system eier avgjørelsen. Hold begrunnelsene nøytrale, varsle dem som trenger å vite det, og husk at tilbakekalling endrer hva verifisererne ser, ikke filene som allerede er i hendene på mottakerne.
Klar til å utstede din første verifiserbare legitimasjon? Kom i gang gratis på badges.ninja — visuell designer, offentlig verifiseringsside, PDF-sertifikat, Open Badge v2.0-utdata. Ingen kredittkort kreves.
Slik ble denne artikkelen laget
Enkelte innlegg på denne bloggen er utarbeidet med hjelp av en KI-assistent, og deretter gjennomgått, faktasjekket og redigert av Badges Ninja-teamet før publisering. Alle kodeeksempler og priser er verifisert mot det faktiske produktet. Les mer om vår redaksjonelle prosess og KI-bruk på vår side om redaksjonell prosess .

Om forfatteren
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.
Mer fra Nacho Coll
- Open Badges for coding bootcamps: Utsted verifiserbare bevis i kohortskala19. nov. 2026 · 10min lesing
- Sette opp webhooks for badge-hendelser: sanntidsintegrasjon med din backend16. nov. 2026 · 9min lesing
- Utløp og fornyelse av Open Badges: livssyklusstyring for tidsbegrensede legitimasjoner12. nov. 2026 · 11min lesing


