Expirarea și reînnoirea Open Badge: managementul ciclului de viață pentru credențiale cu durată limitată

Creditele de educație continuă, certificările și licențele expiră. Setează expirationDate pe Open Badges și reînnoiește-le programatic. Schemă + flux de lucru.

Nacho Coll De Actualizat 12 min de citit
Creditele de educație continuă, certificările și licențele expiră. Setează expirationDate pe Open Badges și reînnoiește-le programatic. Schemă + flux de lucru.

Unele credențiale sunt pe viață. O diplomă nu încetează să fie adevărată pentru că au trecut zece ani. Dar o mare parte dintre credențialele emise de echipele de training sunt exact opusul: o certificare de securitate cibernetică valabilă doi ani, un curs anual de reîmprospătare pentru siguranța utilajelor, un card de RCP, un credit de educație continuă valabil doar pentru un singur ciclu de raportare. Aceste credențiale spun că cineva era competent la o anumită dată, iar afirmația are un termen de valabilitate.

Dacă credențialele tale digitale nu expiră niciodată, le spui discret angajatorilor și auditorilor ceva ce nu este adevărat. Articolul de față explică cum funcționează expirarea în Open Badges, ce vede un verificator când o credențială expiră și un flux practic de reînnoire care nu te obligă să scrii cod, decât dacă vrei tu.

O precizare despre denumire, înainte să începem

Vei vedea oameni căutând „expirationDate”. În specificația Open Badges v2.0, câmpul unei atestări (adică acordarea propriu-zisă, spre deosebire de clasa insignei) se numește expires. Este un șir de tip dată-oră ISO 8601. Câmpul API pe care îl trimiți când emiți o credențială pe https://badges.ninja se numește tot expires. Aceeași idee, dar cu alt nume decât cel pe care îl ghicesc majoritatea, așa că ține minte asta când citești un document JSON-LD sau cauți în documentație.

Două detalii care merită știute:

  • Expirarea ține de acordare, nu de insignă. Aceeași insignă (de exemplu „Annual Safety Training”) poate fi emisă unei persoane cu expirare în martie și alteia cu expirare în septembrie. Exact asta vrei, pentru că valabilitatea se numără de la momentul în care fiecare persoană a încheiat instruirea.
  • Este opțională. Dacă o omiți, credențiala nu expiră niciodată.

Setarea expirării la emitere

Ai trei moduri de a seta o perioadă de valabilitate. Începe cu primele două, pentru că nu necesită cod.

Formularul din panou. Când creezi o credențială, formularul are un câmp opțional „Expires” lângă numele și e-mailul destinatarului. Alege data și emite. Gata.

New Award form

Acordări în masă. Dacă emiți pentru o întreagă cohortă, pagina de acordări în masă primește un CSV cu destinatari și aplică o singură dată de expirare întregului lot, astfel că o clasă care a terminat în aceeași săptămână primește aceeași dată de expirare. Poți pune pe pauză și relua un lot mare. Ghidul nostru despre emiterea de Open Badges dintr-un CSV explică formatul fișierului.

API-ul. Pentru automatizare, de exemplu un hook într-un sistem de management al învățării care emite o credențială când cineva trece examenul, adaugă expires în corpul cererii POST /awards. Acceptă aceleași formate ca issuedOn: milisecunde epoch sau un șir de 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}`;

Același apel în Python:

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

Numele destinatarului trebuie să aibă cel puțin cinci caractere, issuedOn este obligatoriu, iar un apel reușit returnează HTTP 200 cu { awardId }. URL-ul de verificare nu se află în răspuns; îl construiești din id, așa cum se vede mai sus. Contractul complet al cererii se găsește în referința API pentru acordări.

În culise, platforma normalizează orice trimiți într-un șir ISO 8601 și îl stochează în atestarea Open Badges ca expires.

Ce vede un verificator

Aceasta este partea cea mai importantă, pentru că o dată de expirare pe care nu o verifică nimeni este doar decor.

Fiecare acordare are o pagină publică de verificare la https://badges.ninja/awards/<awardId>, iar pentru a o vedea nu e nevoie de cont. Pagina compară data de expirare cu data de azi la fiecare încărcare:

  • Înainte de data expirării: pagina afișează credențiala ca fiind valabilă și arată o linie „valid until” cu data.
  • După data expirării: pagina trece la o notificare „Expired on” cu data. Credențiala rămâne acolo, deci istoricul e intact, dar nimeni nu o poate confunda cu una curentă.
  • Dacă credențiala a fost revocată: revocarea are prioritate față de expirare. O credențială revocată apare ca revocată, nu doar ca expirată.

Verificatorii automați primesc aceleași informații din documentul JSON-LD Open Badge v2.0 de la https://api.badges.ninja/certify-badge/award/<awardId>, unde atestarea conține câmpul expires. Orice instrument care citește standardul își poate aplica propria politică. Un sistem de HR poate refuza categoric o credențială expirată, în timp ce un anuar al absolvenților o poate afișa ca „certificat anterior”.

Credențiala transmite data și mai departe. Butonul „Add to LinkedIn” de pe acordare completează luna și anul expirării în intrarea de certificare de pe LinkedIn, astfel că profilul persoanei reflectă aceeași dată de expirare pe care ai setat-o tu. Și certificatul PDF descărcabil tipărește o dată „Expires” lângă data emiterii.

O consecință care merită spusă pe șleau: expirarea este evaluată în momentul în care se uită cineva, nu de un job care rulează la tine. Nu trebuie să faci nimic în ziua în care o credențială expiră. Nimic nu se „oprește”; pagina de verificare pur și simplu spune adevărul despre dată.

Cum vezi ce urmează să expire

Programele care urmăresc reînnoirile au nevoie de o listă cu cei care urmează la rând. Pagina de acordări din panou are o coloană Expires cu data fiecărei credențiale, iar deschiderea unei credențiale afișează un banner: Active, Expires on o dată sau Expired on o dată.

Awards list

Pentru o campanie de reînnoire, cea mai simplă cale este să selectezi rândurile care te interesează și să folosești Export CSV. Exportul include o coloană „Valid To”. Deschide-l într-o foaie de calcul, sortează după acea coloană și ai o conductă de reînnoiri pentru trimestrul următor în aproximativ un minut.

Să fim sinceri în privința unei limite: platforma nu trimite în prezent, de la sine, e-mailuri automate de tipul „credențiala ta expiră în curând” către destinatari. Tratează memento-ul ca pe un pas din propriul proces. Un tipar frecvent este o intrare în calendar în prima zi a fiecărei luni: exporți CSV-ul, filtrezi datele din următoarele 60–90 de zile și trimiți acelor persoane instrucțiunile de reînnoire din instrumentul tău obișnuit de e-mail. Pentru majoritatea programelor cu câteva sute de credențiale, asta înseamnă zece minute pe lună și mult mai puțin efort decât construirea unui sistem de notificare.

Dacă totuși vrei să automatizezi, endpoint-ul de listare a acordărilor (GET /awards) returnează credențialele tale în pagini de câte 50, iar fiecare înregistrare include data expirării. Un script programat care parcurge lista și trimite e-mail oricui expiră în 60 de zile este un proiect mic. Dar încearcă mai întâi foaia de calcul și automatizează doar când pasul manual chiar te doare.

Tipare de reînnoire

Când cineva reînnoiește, ce ar trebui să se întâmple cu credențiala? Există trei tipare rezonabile, iar cel potrivit depinde de modul în care este definit programul tău de certificare.

Tiparul 1: emite o acordare nouă (recomandat)

Aceasta este abordarea cea mai curată. Persoana încheie cursul de reîmprospătare sau examenul de recertificare, iar tu emiți o acordare nouă din aceeași insignă, cu o dată de emitere nouă și o dată de expirare nouă. Acum deține două credențiale cu aceeași insignă: cea veche, care apare ca expirată, și cea nouă, care apare ca activă.

De ce este de obicei alegerea corectă:

  • Fiecare credențială consemnează un istoric onest: emisă la această dată, valabilă până la cealaltă.
  • URL-ul public vechi continuă să funcționeze și continuă să spună „expired”, ceea ce e corect. Nimeni care și-a salvat linkul nu este indus în eroare.
  • Noua acordare primește propriul URL de verificare, certificat PDF și intrare Add to LinkedIn. Persoana poate înlocui vechea intrare de pe LinkedIn sau le poate păstra pe amândouă pentru a arăta o certificare continuă.
  • Rapoartele tale pot număra reînnoirile pur și simplu numărând acordările per destinatar pentru o insignă.

Ca să păstrezi legătura dintre vechi și nou, o poți trece în criteriile insignei sau în evidențele tale. O insignă de recertificare poate spune: „Renewal of Annual Safety Training, valid after completing the refresher.” Dacă ai nevoie de o legătură fermă în propriul sistem, stochează împreună valorile awardId vechi și noi în baza de date de învățare sau HR când emiți acordarea nouă.

Tiparul 2: editează expirarea pe loc (doar înainte de trimitere)

Platforma permite editarea unei credențiale pe loc, dar doar cât timp nu a fost trimisă prin e-mail și nu a fost revocată. În această fereastră poți corecta numele destinatarului, e-mailul, data emiterii sau data expirării fără a schimba URL-ul acordării. Este pentru corectarea greșelilor, de pildă o dată de expirare greșită introdusă la configurare, nu pentru prelungirea unei credențiale pe care cineva o deține deja.

Odată ce o credențială a fost trimisă prin e-mail destinatarului, ea este blocată. Dacă trebuie să o schimbi după aceea, calea acceptată este să o revoci și să emiți una nouă. Ceea ce ne duce la al treilea tipar.

Tiparul 3: revocă și reemite

Folosește-l atunci când credențiala nu ar mai trebui considerată deloc valabilă, de exemplu persoana și-a pierdut licența în timpul perioadei sau ai emis-o cu insigna greșită. Nu este calea normală de reînnoire, pentru că revocarea transmite un semnal mai puternic decât expirarea: spune că în credențială nu ar fi trebuit să se aibă încredere, nu doar că termenul ei s-a încheiat. Ghidul nostru pas cu pas despre revocarea unui Open Badge explică când se potrivește fiecare variantă.

O regulă simplă: expirarea înseamnă că termenul s-a încheiat; revocarea înseamnă că ceva a fost greșit. Nu revoca credențialele doar pentru că au expirat. Lasă-le să expire și păstrează evidența.

Alegerea perioadei de valabilitate

Datele de expirare sunt decizii de politică, iar a le greși creează bătăi de cap reale. Câteva indicații din programele pe care le vedem funcționând bine:

Tip de credențialăValabilitate tipicăNote
Certificare de securitate cibernetică sau IT2–3 aniInstrumentele și amenințările se schimbă rapid
Instruire anuală de securitate12 luniAdesea legată de o cerință de reglementare
Prim ajutor și RCP2 aniUrmează regula autorității de reglementare, nu o convenție
Credit de educație continuăSfârșitul ciclului de raportareAliniază-l cu ciclul, ca reînnoirile să se grupeze
Finalizarea unui cursFără expirareFinalizarea este un fapt; omite expires

Două sfaturi practice. Întâi, aliniază datele de expirare la un ritm calendaristic acolo unde poți. Dacă toți dintr-o cohortă expiră în aceeași zi, reînnoirea devine o singură campanie în loc de cincizeci. Apoi, nu pune dată de expirare pe credențialele care sunt de fapt dovezi de finalizare. O insignă care spune „a participat la conferința din 2025” nu devine mai puțin adevărată anul viitor, iar o dată de expirare pe ea doar creează confuzie.

Un exemplu concret: o certificare de securitate pe doi ani

Să punem totul cap la cap pentru o echipă de training care rulează o certificare de conștientizare a securității pentru o companie cu 400 de angajați.

  1. Proiectează insigna o singură dată în designerul vizual. Dă-i un nume, setează criteriile (promovarea examenului cu un scor de 80 la sută sau mai mare) și descrie perioada de valabilitate în descriere, ca destinatarii să știe la ce se înscriu.
  2. Emite cu expirare. După fiecare sesiune de examen, încarcă lista celor promovați prin acordări în masă, cu expirarea setată peste doi ani. Fiecare persoană primește e-mailul cu linkul de verificare, certificatul PDF și butonul Add to LinkedIn.
  3. Verifică lunar. În prima zi a lunii, exportă lista de acordări, sortează după „Valid To” și extrage-i pe toți cei care expiră în următoarele 90 de zile.
  4. Invită-i să reînnoiască. Trimite-le linkul examenului de recertificare din instrumentul tău obișnuit de e-mail.
  5. Emite reînnoirea. Când cineva promovează, emite o acordare nouă din aceeași insignă, cu o nouă expirare la doi ani. Cea veche apare singură ca expirată; nu face nimic cu ea.
  6. Răspunde auditorilor cu un link. Când departamentul de conformitate întreabă dacă o persoană este certificată în prezent, trimiți URL-ul de verificare. Acesta arată starea curentă fără să verifici tu nimic.

Fără software personalizat, fără cron job-uri, fără migrări. Exact asta e ideea: managementul ciclului de viață înseamnă în mare parte alegerea unor date potrivite și un obicei lunar.

Greșeli frecvente

  • Setarea unei expirări pe tot. Rezerv-o credențialelor al căror sens chiar se estompează. Altfel creezi muncă de reînnoire fără niciun beneficiu.
  • Confundarea expirării cu revocarea. Revocarea credențialelor expirate distruge istoricul certificării continue și face persoana să pară că nu a fost niciodată validă.
  • Uitarea fusului orar. Data pe care o alegi devine un moment în timp. Dacă o reglementare spune „valabil până la sfârșitul lui martie”, setează expirarea la ultima zi din martie sau la prima zi din aprilie, după cum se citește politica ta, și fii consecvent.
  • Planificarea editării în loc de reemitere. Editarea este disponibilă doar înainte ca credențiala să fie trimisă prin e-mail. Planifică reînnoirile ca acordări noi de la bun început.
  • Lipsa unui proces de memento. Deoarece notificările de expirare nu sunt automatizate, obiceiul trebuie să fie al tău. Pune exportul lunar în calendarul cuiva.

Ce urmează

Dacă credențialele tale vor fi verificate de alte sisteme, merită să citești cum este structurat documentul care poartă expires: prezentarea unui exemplu Open Badge JSON-LD parcurge fiecare câmp al unei atestări. Iar dacă te întrebi dacă merită să plătești în continuare o platformă per credențială pentru toate acestea, comparația noastră cu alternativa la Credly prezintă costurile.

Ești gata să emiți prima ta credențială verificabilă? Începe gratuit pe badges.ninja — designer vizual, pagină publică de verificare, certificat PDF, ieșire Open Badge v2.0. Fără card de credit.

Nacho Coll

Despre autor

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.

Înapoi la Blog

Articole similare