Jak unieważnić Open Badge (i co dzieje się z kopią odbiorcy)
Unieważnianie w Open Badges: jak to działa, co zmienia się dla odbiorcy i jak właściwie rozróżnić „wystawiono przez pomyłkę”, „poświadczenie wygasło” i „naruszenie zasad”.
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.
Prędzej czy później każdy program wydający cyfrowe poświadczenia musi któreś cofnąć. Certyfikat trafił do niewłaściwej osoby. Okazało się, że uczestnik oszukiwał na egzaminie końcowym. Umowa z partnerem dobiegła końca, a odznaki z napisem „Certified Partner” nie powinny już być ważne. Wystawianie to szczęśliwa ścieżka; unieważnianie decyduje o tym, czy twoim poświadczeniom naprawdę można ufać.
Ten przewodnik wyjaśnia, jak działa unieważnianie w Open Badges, co odbiorca widzi (a czego nie) po fakcie oraz jak unieważnić jedno poświadczenie albo kilkaset na https://badges.ninja — z panelu lub przez API.
Co oznacza „unieważnić” w Open Badges
W specyfikacji Open Badges v2.0 każda wystawiona odznaka to assertion: niewielki dokument JSON-LD hostowany pod publicznym adresem URL, który mówi: „ten wystawca przyznał tę odznakę temu odbiorcy w tym dniu”. Unieważnienie to po prostu zmiana tego hostowanego dokumentu. Assertion dostaje "revoked": true oraz opcjonalnie ciąg "revocationReason" z wyjaśnieniem powodu.
Takie rozwiązanie ma ważną konsekwencję, która zaskakuje wielu właścicieli programów:
- Hostowany assertion jest źródłem prawdy. Każdy, kto weryfikuje poświadczenie, pobierając adres assertion lub otwierając stronę weryfikacji, od razu widzi stan „unieważnione”.
- Kopie nie są wycofywane. Jeśli odbiorca pobrał obraz odznaki lub plik JSON albo przypiął go w portfolio, ten plik się nie zmienia. Nadal zawiera link do twojego hostowanego assertion, więc weryfikator, który kliknie ten link, zobaczy unieważnienie, ale osoba patrząca na zapisany plik PNG — nie.
Unieważnienie jest więc oświadczeniem złożonym w punkcie weryfikacji, a nie usunięciem. Wyobraź sobie, że przybijasz pieczęć „NIEWAŻNE” na oryginalnym rekordzie, zamiast ganiać za każdą kserokopią.
Jeśli chcesz przyjrzeć się samemu dokumentowi, nasz przewodnik po Open Badge JSON-LD omawia każde pole.
Unieważnić, wystawić ponownie czy usunąć: wybierz właściwą akcję
Zanim cokolwiek klikniesz, zdecyduj, która z trzech akcji pasuje do sytuacji. Nie są wymienne.
| Sytuacja | Najlepsza akcja | Dlaczego |
|---|---|---|
| Poświadczenie wystawiono niewłaściwej osobie lub z literówką | Usuń (jeśli nie zostało wysłane) albo unieważnij, a potem wystaw ponownie | Usunięcie kasuje rekord całkowicie; unieważnienie zachowuje ślad audytowy |
| Uczestnik naruszył zasady lub poświadczenie uzyskano w nieuczciwy sposób | Unieważnij, podając powód | Rekord pozostaje weryfikowalny jako unieważniony, a tego chcesz w razie sporu |
| Poświadczenie po prostu osiągnęło datę końcową | Nie rób nic; ustaw datę wygaśnięcia przy wystawianiu | Wygaśnięcie to normalne zdarzenie cyklu życia, a nie unieważnienie |
| Program anulowano, kohorta unieważniona | Unieważnienie zbiorcze | Jedno zadanie, jeden powód, zastosowane do wszystkich |
| Dane były błędne, ale poza tym poświadczenie jest ważne | Edytuj przed wysłaniem albo unieważnij i wystaw ponownie po wysłaniu | Zachowuje komfort odbiorcy |
Dwie żelazne zasady:
- Wybieraj unieważnienie zamiast usunięcia we wszystkim, co prawdziwe. Publiczna strona usuniętego poświadczenia zwraca błąd „nie znaleziono”. Unieważnione nadal się otwiera i wyraźnie mówi, że jest unieważnione, co jest znacznie lepszym dowodem, gdy ktoś później zapyta, co się stało.
- Nigdy nie używaj unieważnienia zamiast wygaśnięcia. Jeśli poświadczenie jest ważne tylko dwa lata, ustaw datę wygaśnięcia przy wystawianiu. Odznaka, która cicho traci ważność, to co innego niż wycofana, a twoja strona weryfikacji powinna mówić, o którą chodzi.
Unieważnianie z panelu
Przy kilku poświadczeniach panel to najszybsza droga i nie wymaga kodu.
- Zaloguj się i otwórz Awards na pasku bocznym.
- Znajdź poświadczenie. Lista pokazuje odbiorcę, nazwę odznaki, datę wystawienia i wygaśnięcia, a wyszukiwać możesz po odbiorcy.
- Kliknij wiersz (lub View), aby otworzyć okno szczegółów poświadczenia.
- Kliknij Revoke.
- W oknie potwierdzenia opcjonalnie wpisz powód i opcjonalnie zaznacz Email the recipient that their credential was revoked.
- Potwierdź.

Poświadczenie zostaje na twojej liście z czerwonym znacznikiem Revoked obok odbiorcy, dzięki czemu ty i twój zespół zawsze widzicie, co zostało wycofane. Unieważnienie nie zwraca poświadczenia do limitu w twoim planie. Wystawiłeś je, więc się liczy.
Uwaga o polu powodu
Powód jest opcjonalny, ale wypełnij go. Jest przechowywany razem z poświadczeniem, pojawia się jako revocationReason w publicznym assertion Open Badges i jest dołączany do payloadu webhooka, który otrzymują twoje systemy. Ponieważ jest publiczny w assertion, pisz go tak, jak dla zewnętrznego czytelnika. „Issued in error” albo „Program cancelled” jest w porządku. „Jane oszukiwała w pytaniu 14” — nie. Dane osobowe trzymaj we własnych rejestrach, a publiczny powód niech będzie neutralny.
Czy wysyłać e-mail do odbiorcy?
Zwykle tak. Uczestnik, który dowiaduje się o unieważnieniu dopiero wtedy, gdy pracodawca kliknie link weryfikacyjny, ma pełne prawo być na ciebie zły. Powiadomienie jest opcjonalne właśnie dlatego, że część unieważnień (na przykład zbiorcze sprzątanie testowych przyznań) nie wymaga niepokojenia nikogo. Nasza rada:
- Wysyłaj e-mail, gdy unieważnienie dotyczy realnej osoby, która może nadal pokazywać to poświadczenie.
- Pomiń e-mail, gdy porządkujesz wewnętrzne dane testowe lub unieważniasz poświadczenia, które nigdy nie zostały wysłane.
Unieważnianie wielu poświadczeń naraz
Programy rzadko potrzebują unieważnić jedno poświadczenie w oderwaniu; częściej chodzi o całą kohortę. Na liście Awards:
- Zaznacz pola wyboru przy poświadczeniach, które chcesz wycofać.
- Kliknij Revoke selected na pasku akcji zbiorczych.
- Dodaj powód, zdecyduj, czy powiadomić odbiorców, i potwierdź.
Unieważnianie zbiorcze działa jako trwałe zadanie w tle, więc kilkaset poświadczeń nie przekroczy limitu czasu karty przeglądarki. Poświadczenia już unieważnione są pomijane, zamiast przerywać całą partię, a zadanie przerwane w połowie można wznowić. Ten sam mechanizm napędza zbiorcze wystawianie z arkusza, które opisujemy w jak wystawiać Open Badges z pliku CSV.
Unieważnianie przez API
Jeśli twój system nauczania lub platforma HR decyduje, kto przestaje być certyfikowany, możesz unieważniać programowo. Endpoint to POST /awards/{awardId}/revoke, uwierzytelniany kluczem API (X-Api-Key: bws_<32-hex>) lub tokenem Bearer z Cognito. Identyfikator przyznania trafia do ścieżki; reason i notify trafiają do ciała JSON i oba są opcjonalne.
Za pomocą 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>"}
W JavaScripcie:
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
I w Pythonie:
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
Kilka praktycznych szczegółów, które warto znać:
- Jest idempotentne. Unieważnienie poświadczenia, które już jest unieważnione, zwraca tę samą odpowiedź sukcesu i nie wysyła drugiego powiadomienia. Dzięki temu można bezpiecznie wywoływać je z zadania z ponawianiem.
- Powody są obcinane do 500 znaków.
notifydomyślnie ma wartość false. Nic nie jest wysyłane e-mailem, dopóki o to nie poprosisz.- Unieważnianie zbiorcze jest dostępne przez endpoint zbiorczy z
action: "revoke"i listą identyfikatorów przyznań; zwraca identyfikator zadania, które możesz śledzić. Pełne parametry znajdziesz w dokumentacji API awards.
API jest potrzebne tylko wtedy, gdy unieważnienie wynika z innego systemu. Przy pojedynczym przypadku panel jest szybszy i ma krok potwierdzenia, który chroni przed błędnie wpisanym identyfikatorem.
Co widzą odbiorca i weryfikator
Po unieważnieniu zmienia się to, co poniżej, i to szybko.
Na publicznej stronie weryfikacji. Strona pod adresem https://badges.ninja/awards/<award-id> pokazuje poświadczenie jako unieważnione, a tytuł strony przy udostępnianiu w mediach społecznościowych dostaje prefiks „[Revoked]”, żeby udostępniony link nie wyglądał w karcie podglądu jak aktywne poświadczenie.
W assertion Open Badges v2.0. Hostowany JSON pod https://api.badges.ninja/certify-badge/award/<award-id> zawiera teraz "revoked": true oraz "revocationReason", jeśli go podałeś. Unieważnione assertiony są cache’owane tylko przez około 30 sekund, podczas gdy aktywne przez pięć minut, więc zmiana szybko dociera do weryfikatorów.
W poświadczeniu Open Badges 3.0. Unieważnienie przestawia także bit poświadczenia na liście W3C Bitstring Status List, dzięki której wykrywają je portfele i weryfikatory verifiable credentials. Ta lista jest krótko cache’owana, więc spodziewaj się propagacji w ciągu około minuty. Jeśli porównujesz obie wersje, zobacz Open Badges v2 vs v3.
W kopii odbiorcy. Nic się nie zmienia w pobranym pliku. Obraz odznaki na jego laptopie wygląda tak samo. Zmienia się wynik weryfikacji: każdy, kto kliknie link lub sprawdzi poświadczenie programowo, dostaje odpowiedź „unieważnione”. Jeśli go powiadomiłeś, ma też e-mail z wyjaśnieniem powodu.
Na LinkedIn. Poświadczenie dodane do profilu LinkedIn to link plus metadane wskazujące na twoją stronę weryfikacji. LinkedIn nie sprawdza za ciebie unieważnień, więc wpis może wisieć na profilu, ale każdy, kto kliknie link, trafi na stronę unieważnienia. To kolejny powód, by wysłać powiadomienie i poprosić odbiorcę o usunięcie wpisu.
Poinformuj własne systemy: webhooki
Unieważnienie rzadko kończy sprawę wewnątrz twojej organizacji. Uczestnik może stracić dostęp do społeczności, może trzeba zaktualizować rekord pracodawcy albo usunąć tag w CRM. Badges Ninja wysyła zdarzenie webhooka credential.revoked, gdy poświadczenie zostaje unieważnione, z adresem przyznania i powodem:
{
"awardId": "https://api.badges.ninja/certify-badge/award/<award-id>",
"reason": "Issued in error"
}
Zasubskrybuj je, a twoje systemy podrzędne pozostaną zsynchronizowane bez konieczności pamiętania o ręcznych aktualizacjach. Szczegóły konfiguracji są w dokumentacji webhooków, a szerszy model zdarzeń omawiamy w konfiguracji webhooków dla zdarzeń odznak.
Prosta polityka unieważniania, którą możesz przyjąć już dziś
Narzędzia to łatwa połowa. Trudniejsza to ustalenie z wyprzedzeniem, kiedy będziesz unieważniać i kto ma do tego prawo. Krótka, spisana polityka zapobiega późniejszym sporom. Działający szablon:
- Podstawy unieważnienia. Wypisz je: wystawienie przez pomyłkę, uzyskanie przez niewłaściwe postępowanie, niespełnienie już wymogu (na przykład wygasło członkostwo) lub wycofanie programu.
- Kto decyduje. Wskaż rolę, nie osobę. Ogranicz uprawnienie do unieważniania do tej roli.
- Powiadomienie. Zaznacz, że odbiorcy są informowani e-mailem wraz z powodem, chyba że poświadczenie nigdy nie zostało dostarczone.
- Odwołanie. Daj odbiorcom sposób na zakwestionowanie decyzji i napisz, ile czasu zajmie odpowiedź. Jeśli odwołanie zostanie uwzględnione, wystaw nowe poświadczenie zamiast próbować cofać unieważnienie — wtedy historia pozostaje czysta.
- Rejestr. Prowadź wewnętrzną notatkę, kto co unieważnił i dlaczego, osobno od neutralnego publicznego powodu.
Opublikuj politykę na tej samej stronie, na której opisujesz poświadczenie, aby uczestnicy znali zasady, zanim się zapiszą.
Typowe błędy, których warto unikać
- Usunięcie zamiast unieważnienia. Usunięcie jest trwałe i nie da się go cofnąć, a publiczna strona znika. Używaj go przy rzeczywistych pomyłkach w poświadczeniach, których nikt nie widział.
- Prywatne szczegóły w powodzie. Jest publiczny w assertion.
- Oczekiwanie, że zapisane kopie się zmienią. Unieważnienie żyje w punkcie weryfikacji. Powiedz odbiorcom, żeby usunęli poświadczenie z profili i portfolio.
- Unieważnianie zamiast wygaszania. Dla poświadczeń ograniczonych w czasie użyj daty wygaśnięcia.
- Zakładanie zwrotu. Unieważnione poświadczenia nadal liczą się do limitu twojego planu.
- Zapominanie o systemach podrzędnych. Podłącz webhook, aby dostępy i rekordy podążały za statusem poświadczenia.
Najczęściej zadawane pytania
Czy mogę cofnąć unieważnienie? Nie przez interfejs. Jeśli unieważniłeś przez pomyłkę, wystaw odbiorcy nowe poświadczenie. Unieważnione pozostaje jako część śladu audytowego.
Czy odbiorca musi coś zrobić? Nie. Jeśli wybrałeś powiadomienie, dostaje e-mail. W przeciwnym razie zmiana następuje po cichu na stronie weryfikacji.
Czy unieważnianie działa dla poświadczeń, które nigdy nie zostały wysłane? Tak, choć przy niewysłanym poświadczeniu z prostym błędem możesz wolić edytować je przed wysłaniem albo usunąć, jeśli nikt go nie widział.
Czy jest limit liczby unieważnień? Unieważnianie zbiorcze działa jako wznawialne zadanie w tle, więc duże partie obsługuje się jedną operacją zamiast pojedynczo.
Czy pracodawcy zobaczą, że poświadczenie unieważniono? Każdy, kto weryfikuje je przez publiczny adres URL lub assertion, widzi status unieważnienia i powód, jeśli go podałeś.
Podsumowanie
Unieważnienie Open Badge to mała akcja z realnymi skutkami dla zaufania. Rób to z panelu, gdy chodzi o jedno poświadczenie, używaj unieważniania zbiorczego dla kohorty, a po API lub webhooki sięgaj, gdy decyzję podejmuje inny system. Pisz neutralne powody, powiadamiaj osoby, które powinny wiedzieć, i pamiętaj: unieważnienie zmienia to, co widzą weryfikatorzy, a nie pliki, które odbiorcy już mają.
Gotowy wystawić swoje pierwsze weryfikowalne poświadczenie? Zacznij za darmo na badges.ninja — wizualny projektant, publiczna strona weryfikacji, certyfikat PDF, wyjście Open Badge v2.0. Karta kredytowa nie jest wymagana.
Jak powstał ten artykuł
Niektóre wpisy na tym blogu powstają z pomocą asystenta AI, a następnie są sprawdzane, weryfikowane merytorycznie i redagowane przez zespół Badges Ninja przed publikacją. Każdy przykład kodu i cena są weryfikowane względem działającego produktu. Więcej o naszym procesie redakcyjnym i wykorzystaniu AI przeczytasz na naszej stronie procesu redakcyjnego .

O autorze
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.
Więcej od Nacho Coll
- Open Badges dla bootcampów programistycznych: weryfikowalne poświadczenia na skalę kohorty19 lis 2026 · 10min czytania
- Konfiguracja webhooków dla zdarzeń odznak: integracja z Twoim backendem w czasie rzeczywistym16 lis 2026 · 8min czytania
- Wygasanie i odnawianie Open Badge: zarządzanie cyklem życia poświadczeń ograniczonych czasowo12 lis 2026 · 10min czytania


