Wygasanie i odnawianie Open Badge: zarządzanie cyklem życia poświadczeń ograniczonych czasowo

Punkty CE, certyfikaty i licencje wygasają. Ustaw expirationDate w Open Badge i odnawiaj je programowo. Schemat + przepływ pracy.

Nacho Coll Autor Zaktualizowano 10 min czytania
Punkty CE, certyfikaty i licencje wygasają. Ustaw expirationDate w Open Badge i odnawiaj je programowo. Schemat + przepływ pracy.

Niektóre poświadczenia są na całe życie. Dyplom nie przestaje być prawdziwy dlatego, że minęło dziesięć lat. Ale duża część poświadczeń wydawanych przez zespoły szkoleniowe jest zupełnie odwrotna: dwuletni certyfikat z cyberbezpieczeństwa, coroczne odświeżenie szkolenia z obsługi wózków widłowych, karta CPR, punkt edukacji ciągłej ważny tylko przez jeden cykl sprawozdawczy. Takie poświadczenia mówią, że ktoś był kompetentny na dany dzień, a ta informacja ma termin przydatności.

Jeśli Twoje cyfrowe poświadczenia nigdy nie wygasają, po cichu mówisz pracodawcom i audytorom coś, co nie jest prawdą. Ten artykuł pokazuje, jak działa wygasanie w Open Badges, co widzi weryfikator, gdy poświadczenie traci ważność, oraz praktyczny przepływ odnawiania, który nie wymaga pisania kodu, chyba że sam tego chcesz.

Jedna uwaga o nazwie na start

Wiele osób wyszukuje „expirationDate”. W specyfikacji Open Badges v2.0 pole w przyznaniu (czyli w samym nadaniu odznaki, w odróżnieniu od klasy odznaki) nazywa się expires. To ciąg znaków z datą i czasem w formacie ISO 8601. Pole API, które wysyłasz przy wystawianiu poświadczenia na https://badges.ninja, również nazywa się expires. To ta sama idea, tylko pod inną nazwą, niż większość się spodziewa, więc miej to na uwadze, czytając dokument JSON-LD lub przeszukując dokumentację.

Dwie rzeczy warte zapamiętania:

  • Wygasanie dotyczy przyznania, a nie odznaki. Ta sama odznaka (powiedzmy „Annual Safety Training”) może zostać wydana jednej osobie z terminem ważności w marcu, a drugiej z terminem we wrześniu. I o to chodzi, bo ważność liczy się od momentu ukończenia szkolenia przez każdą osobę.
  • Pole jest opcjonalne. Pomiń je, a poświadczenie nigdy nie wygaśnie.

Ustawianie terminu ważności przy wystawianiu

Masz trzy sposoby ustawienia okresu ważności. Zacznij od dwóch pierwszych, bo nie wymagają kodu.

Formularz w panelu. Podczas tworzenia poświadczenia formularz zawiera opcjonalne pole daty „Expires” obok imienia i nazwiska oraz adresu e-mail odbiorcy. Wybierasz datę i wystawiasz. To cała robota.

New Award form

Przyznania zbiorcze. Jeśli wystawiasz poświadczenia całej grupie, strona przyznań zbiorczych przyjmuje plik CSV z odbiorcami i stosuje jedną datę ważności do całej partii, dzięki czemu kurs zakończony w tym samym tygodniu wygasa tego samego dnia. Dużą partię możesz wstrzymać i wznowić. Format pliku opisujemy w naszym poradniku o wystawianiu Open Badges z pliku CSV.

API. Do automatyzacji, na przykład hooka w systemie zarządzania nauczaniem, który wystawia poświadczenie po zdaniu egzaminu, dodaj expires do treści żądania POST /awards. Akceptuje te same formaty co issuedOn: milisekundy epoki lub ciąg z datą ISO.

// Issue a 2-year certification
const issuedOn = Date.now();
const twoYears = 2 * 365 * 24 * 60 * 60 * 1000;
const res = await fetch("https://api.badges.ninja/awards", {
  method: "POST",
  headers: { "X-Api-Key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    badgeId: "your-badge-id",
    recipient: { name: "Jane Smith", email: "jane@example.com" },
    issuedOn,
    expires: issuedOn + twoYears,
  }),
});
const { awardId } = await res.json();       // 200 OK
const verifyUrl = `https://badges.ninja/awards/${awardId}`;

To samo wywołanie w Pythonie:

import time, requests
issued = int(time.time() * 1000)
two_years = 2 * 365 * 24 * 60 * 60 * 1000
res = requests.post(
    "https://api.badges.ninja/awards",
    headers={"X-Api-Key": API_KEY},
    json={
        "badgeId": "your-badge-id",
        "recipient": {"name": "Jane Smith", "email": "jane@example.com"},
        "issuedOn": issued,
        "expires": issued + two_years,
    },
)
award_id = res.json()["awardId"]            # 200 OK

Imię i nazwisko odbiorcy musi mieć co najmniej pięć znaków, issuedOn jest wymagane, a udane wywołanie zwraca HTTP 200 z { awardId }. Adresu weryfikacyjnego nie ma w odpowiedzi; budujesz go z identyfikatora, jak pokazano wyżej. Pełny kontrakt żądania znajdziesz w dokumentacji API przyznań.

W tle platforma normalizuje wszystko, co wyślesz, do ciągu ISO 8601 i zapisuje go w przyznaniu Open Badges jako expires.

Co widzi weryfikator

To najważniejsza część, ponieważ data ważności, której nikt nie sprawdza, jest tylko ozdobą.

Każde przyznanie ma publiczną stronę weryfikacji pod adresem https://badges.ninja/awards/<awardId>, a do jej obejrzenia nie trzeba się rejestrować. Strona porównuje datę wygaśnięcia z dzisiejszą datą przy każdym załadowaniu:

  • Przed datą wygaśnięcia: strona pokazuje poświadczenie jako ważne i wyświetla wiersz „valid until” z datą.
  • Po dacie wygaśnięcia: strona zmienia się na komunikat „Expired on” z datą. Poświadczenie nadal tam jest, więc historia pozostaje nienaruszona, ale nikt nie pomyli go z aktualnym.
  • Jeśli poświadczenie zostało unieważnione: unieważnienie ma pierwszeństwo przed wygaśnięciem. Unieważnione poświadczenie wyświetla się jako unieważnione, a nie po prostu wygasłe.

Weryfikatory maszynowe dostają te same informacje z dokumentu JSON-LD Open Badge v2.0 pod adresem https://api.badges.ninja/certify-badge/award/<awardId>, gdzie przyznanie zawiera pole expires. Każde narzędzie czytające standard może zastosować własną politykę. System HR może odrzucić wygasłe poświadczenie wprost, a katalog absolwentów może pokazać je jako „dawniej certyfikowany”.

Poświadczenie niesie datę również na zewnątrz. Przycisk „Add to LinkedIn” przy przyznaniu uzupełnia miesiąc i rok wygaśnięcia we wpisie certyfikatu na LinkedIn, więc profil tej osoby odzwierciedla ten sam termin, który ustawiłeś. Pobieralny certyfikat PDF także drukuje datę „Expires” obok daty wystawienia.

Jedna konsekwencja warta jasnego wyrażenia: wygaśnięcie jest oceniane w chwili, gdy ktoś patrzy, a nie przez zadanie uruchamiane po Twojej stronie. Nie musisz nic robić w dniu utraty ważności. Nic nie zostaje „wyłączone”; strona weryfikacji po prostu mówi prawdę o dacie.

Podgląd tego, co wkrótce straci ważność

Programy śledzące odnowienia potrzebują listy osób, którym zbliża się termin. Strona przyznań w panelu ma kolumnę Expires pokazującą datę każdego poświadczenia, a po otwarciu poświadczenia widać baner: Active, Expires on z datą albo Expired on z datą.

Awards list

W kampanii odnowień najprościej zaznaczyć interesujące Cię wiersze i użyć Export CSV. Eksport zawiera kolumnę „Valid To”. Otwórz go w arkuszu kalkulacyjnym, posortuj po tej kolumnie i w około minutę masz potok odnowień na następny kwartał.

Musimy uczciwie wspomnieć o jednym ograniczeniu: platforma obecnie nie wysyła sama automatycznych e-maili „Twoje poświadczenie wkrótce wygaśnie” do odbiorców. Potraktuj przypomnienie jako krok we własnym procesie. Częsty wzorzec to wpis w kalendarzu na pierwszy dzień każdego miesiąca: eksportujesz CSV, filtrujesz daty w ciągu najbliższych 60–90 dni i wysyłasz tym osobom instrukcje odnowienia ze swojego zwykłego narzędzia do poczty. W większości programów z kilkuset poświadczeniami zajmuje to dziesięć minut miesięcznie i jest znacznie mniej pracy niż budowa systemu powiadomień.

Jeśli jednak chcesz to zautomatyzować, endpoint listy przyznań (GET /awards) zwraca Twoje poświadczenia w stronach po 50, a każdy rekord zawiera termin ważności. Zaplanowany skrypt, który przechodzi po liście i wysyła e-mail każdemu, komu ważność kończy się w ciągu 60 dni, to mały projekt. Ale najpierw wypróbuj arkusz i automatyzuj dopiero wtedy, gdy ręczny krok naprawdę zaczyna boleć.

Wzorce odnawiania

Co powinno się stać z poświadczeniem, gdy ktoś je odnawia? Są trzy rozsądne wzorce, a właściwy zależy od tego, jak zdefiniowany jest Twój program certyfikacji.

Wzorzec 1: wystaw nowe przyznanie (zalecane)

To najczystsze podejście. Osoba kończy odświeżenie lub egzamin rekertyfikacyjny, a Ty wystawiasz nowe przyznanie z tej samej odznaki ze świeżą datą wystawienia i nowym terminem ważności. Ma wtedy dwa poświadczenia z tą samą odznaką: stare, które pokazuje się jako wygasłe, i nowe, które jest aktywne.

Dlaczego to zwykle właściwy wybór:

  • Każde poświadczenie rzetelnie zapisuje historię: wystawione tego dnia, ważne do tamtego dnia.
  • Stary publiczny adres URL nadal działa i nadal mówi „expired”, co jest zgodne z prawdą. Nikt, kto go zapisał w zakładkach, nie zostaje wprowadzony w błąd.
  • Nowe przyznanie dostaje własny adres weryfikacyjny, certyfikat PDF i wpis Add to LinkedIn. Osoba może zastąpić stary wpis na LinkedIn albo zachować oba, by pokazać ciągłość certyfikacji.
  • Twoje raporty policzą odnowienia po prostu przez zliczenie przyznań na odbiorcę dla danej odznaki.

Aby zachować powiązanie starego z nowym, zapisz je w kryteriach odznaki lub we własnej ewidencji. Odznaka rekertyfikacyjna może mówić: „Odnowienie Annual Safety Training, ważne po ukończeniu odświeżenia”. Jeśli potrzebujesz twardego powiązania we własnym systemie, przechowuj stare i nowe wartości awardId razem w bazie systemu nauczania lub HR przy wystawianiu nowego przyznania.

Wzorzec 2: edytuj termin ważności w miejscu (tylko przed wysłaniem)

Platforma pozwala edytować poświadczenie w miejscu, ale tylko dopóki nie zostało wysłane e-mailem i nie zostało unieważnione. W tym oknie możesz poprawić imię i nazwisko odbiorcy, e-mail, datę wystawienia lub termin ważności bez zmiany adresu URL przyznania. Służy to do poprawiania błędów, takich jak zła data ważności wpisana podczas konfiguracji, a nie do przedłużania poświadczenia, które ktoś już posiada.

Gdy poświadczenie zostanie wysłane e-mailem do odbiorcy, jest zablokowane. Jeśli po tym trzeba je zmienić, wspieraną drogą jest unieważnienie go i wystawienie nowego. To prowadzi nas do trzeciego wzorca.

Wzorzec 3: unieważnij i wystaw ponownie

Użyj tego, gdy poświadczenie w ogóle nie powinno być już uznawane za ważne, na przykład osoba straciła licencję w trakcie okresu albo wystawiłeś je z niewłaściwą odznaką. To nie jest normalna ścieżka odnawiania, bo unieważnienie wysyła mocniejszy sygnał niż wygaśnięcie: mówi, że poświadczeniu nie należało ufać, a nie tylko że jego okres się skończył. Nasz przewodnik krok po kroku o unieważnianiu Open Badge opisuje, kiedy stosować które.

Dobra reguła kciuka: wygaśnięcie oznacza, że okres się skończył; unieważnienie oznacza, że coś było nie tak. Nie unieważniaj poświadczeń tylko dlatego, że straciły ważność. Pozwól im wygasnąć i zachowaj zapis.

Dobór okresu ważności

Terminy ważności to decyzje polityczne, a pomyłki powodują realne kłopoty. Kilka wskazówek z programów, które widzimy, że działają dobrze:

Typ poświadczeniaTypowa ważnośćUwagi
Certyfikat z cyberbezpieczeństwa lub IT2 do 3 latNarzędzia i zagrożenia szybko się zmieniają
Coroczne szkolenie BHP12 miesięcyCzęsto powiązane z wymogiem regulacyjnym
Pierwsza pomoc i CPR2 lataStosuj się do przepisów swojego regulatora, a nie do konwencji
Punkt edukacji ciągłejKoniec cyklu sprawozdawczegoDopasuj do cyklu, by odnowienia szły w partiach
Ukończenie kursuBez wygasaniaUkończenie to fakt; pomiń expires

Dwie praktyczne wskazówki. Po pierwsze, tam gdzie to możliwe, dopasuj daty wygaśnięcia do rytmu kalendarza. Jeśli cała grupa traci ważność tego samego dnia, odnowienie staje się jedną kampanią zamiast pięćdziesięciu. Po drugie, nie ustawiaj terminu ważności na poświadczeniach, które tak naprawdę są zapisem ukończenia. Odznaka mówiąca „uczestniczył w konferencji 2025” nie staje się mniej prawdziwa w przyszłym roku, a data wygaśnięcia na niej tylko wprowadza zamieszanie.

Przykład z praktyki: dwuletni certyfikat bezpieczeństwa

Złóżmy to w całość dla zespołu szkoleniowego prowadzącego certyfikację świadomości bezpieczeństwa w firmie z 400 pracownikami.

  1. Zaprojektuj odznakę raz w projektancie wizualnym. Nadaj nazwę, ustaw kryteria (zdanie egzaminu z wynikiem 80 procent lub wyższym) i opisz okres ważności w opisie, aby odbiorcy wiedzieli, na co się decydują.
  2. Wystawiaj z terminem ważności. Po każdej sesji egzaminacyjnej wgraj listę osób, które zdały, przez przyznania zbiorcze z terminem ważności ustawionym na dwa lata do przodu. Każda osoba otrzymuje e-mail z linkiem weryfikacyjnym, certyfikatem PDF i przyciskiem Add to LinkedIn.
  3. Sprawdzaj co miesiąc. Pierwszego dnia miesiąca wyeksportuj listę przyznań, posortuj po „Valid To” i wybierz wszystkich, którym ważność kończy się w ciągu 90 dni.
  4. Zaproś ich do odnowienia. Wyślij tym osobom link do egzaminu rekertyfikacyjnego ze swojego zwykłego narzędzia do poczty.
  5. Wystaw odnowienie. Gdy ktoś zda, wystaw nowe przyznanie z tej samej odznaki z nowym dwuletnim terminem. Stare samo pokaże się jako wygasłe; nic z nim nie rób.
  6. Odpowiadaj audytorom linkiem. Gdy dział zgodności pyta, czy dana osoba ma aktualny certyfikat, wysyłasz adres weryfikacyjny. Pokazuje on bieżący status bez żadnego sprawdzania z Twojej strony.

Żadnego własnego oprogramowania, zadań cron ani migracji. O to właśnie chodzi: zarządzanie cyklem życia to w większości kwestia wyboru rozsądnych dat i miesięcznego nawyku.

Częste błędy

  • Ustawianie terminu ważności na wszystkim. Zarezerwuj go dla poświadczeń, których znaczenie naprawdę blednie. W przeciwnym razie tworzysz pracę przy odnowieniach bez żadnej korzyści.
  • Mylenie wygaśnięcia z unieważnieniem. Unieważnianie wygasłych poświadczeń niszczy historię ciągłej certyfikacji i sprawia, że osoba wygląda, jakby nigdy nie była uprawniona.
  • Zapominanie o strefie czasowej. Wybrana data staje się punktem w czasie. Jeśli przepis mówi „ważne do końca marca”, ustaw wygaśnięcie na ostatni dzień marca albo pierwszy dzień kwietnia, zależnie od brzmienia Twojej polityki, i bądź konsekwentny.
  • Planowanie edycji zamiast ponownego wystawienia. Edycja jest dostępna tylko przed wysłaniem poświadczenia e-mailem. Od początku planuj odnowienia jako nowe przyznania.
  • Brak procesu przypomnień. Ponieważ powiadomienia o wygaśnięciu nie są zautomatyzowane, nawyk musi być Twój. Wpisz comiesięczny eksport do czyjegoś kalendarza.

Co dalej

Jeśli Twoje poświadczenia będą sprawdzane przez inne systemy, warto przeczytać, jak zbudowany jest dokument niosący expires: Open Badge JSON-LD example walkthrough omawia każde pole przyznania. A jeśli zastanawiasz się, czy dalej płacić platformie za każde poświadczenie, nasze porównanie alternatyw dla Credly przedstawia koszty.

Gotowy, by wystawić swoje pierwsze weryfikowalne poświadczenie? Zacznij za darmo na badges.ninja — projektant wizualny, publiczna strona weryfikacji, certyfikat PDF, wyjście Open Badge v2.0. Karta kredytowa niepotrzebna.

Nacho Coll

O autorze

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.

Powrót do bloga

Powiązane artykuły