Scadenza e rinnovo degli Open Badge: gestire il ciclo di vita delle credenziali a tempo
Crediti formativi, certificazioni e licenze scadono tutti. Imposta la data di scadenza sugli Open Badge e rinnovali in modo programmatico. Schema + flusso di lavoro.
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.
Alcune credenziali valgono per sempre. Una laurea non smette di essere vera perché sono passati dieci anni. Ma una buona parte delle credenziali che i team di formazione rilasciano è l’esatto opposto: una certificazione di cybersecurity biennale, un richiamo annuale sulla sicurezza dei carrelli elevatori, un attestato di BLS, un credito di formazione continua valido per un solo ciclo di rendicontazione. Queste credenziali affermano che qualcuno era competente a una certa data, e quell’affermazione ha una data di scadenza.
Se le tue credenziali digitali non scadono mai, stai dicendo silenziosamente a datori di lavoro e auditor qualcosa che non è vero. Questo articolo spiega come funziona la scadenza negli Open Badge, che cosa vede un verificatore quando una credenziale decade e un flusso di rinnovo pratico che non richiede di scrivere codice, a meno che tu non voglia.
Una nota sui nomi prima di iniziare
Vedrai che la gente cerca “expirationDate”. Nella specifica Open Badges v2.0, il campo di un’assertion (il conferimento vero e proprio, in contrapposizione alla badge class) si chiama expires. È una stringa data-ora ISO 8601. Anche il campo API che invii quando rilasci una credenziale su https://badges.ninja si chiama expires. Stessa idea, nome diverso da quello che la maggior parte delle persone immagina: tienilo a mente quando leggi un documento JSON-LD o cerchi nella documentazione.
Due dettagli utili da sapere:
- La scadenza vive sul conferimento, non sul badge. Lo stesso badge (ad esempio “Formazione annuale sulla sicurezza”) può essere rilasciato a una persona con scadenza a marzo e a un’altra con scadenza a settembre. È proprio ciò che ti serve, perché la validità si calcola da quando ciascuna persona ha completato la formazione.
- È facoltativa. Se la ometti, la credenziale non scade mai.
Impostare una scadenza al momento del rilascio
Hai tre modi per definire un periodo di validità. Parti dai primi due, perché non richiedono codice.
Il modulo della dashboard. Quando crei una credenziale, il modulo ha un campo facoltativo “Expires” accanto al nome e all’email del destinatario. Scegli la data e rilascia. Tutto qui.

Conferimenti in blocco. Se rilasci a un’intera coorte, la pagina dei conferimenti in blocco accetta un CSV di destinatari e applica un’unica data di scadenza al lotto, così una classe che ha finito nella stessa settimana ottiene la stessa data di decadenza. Puoi mettere in pausa e riprendere un lotto di grandi dimensioni. La nostra guida su come rilasciare Open Badge da un CSV spiega il formato del file.
L’API. Per l’automazione, ad esempio un hook del sistema di gestione dell’apprendimento che rilascia una credenziale quando qualcuno supera l’esame, aggiungi expires al corpo di POST /awards. Accetta gli stessi formati di issuedOn: millisecondi epoch o una stringa di data 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}`;
La stessa chiamata in 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
Il nome del destinatario deve avere almeno cinque caratteri, issuedOn è obbligatorio e una chiamata riuscita restituisce HTTP 200 con { awardId }. L’URL di verifica non è nella risposta: lo costruisci a partire dall’id come mostrato. Il contratto completo della richiesta è nel riferimento API dei conferimenti.
Dietro le quinte, la piattaforma normalizza ciò che invii in una stringa ISO 8601 e la memorizza nell’assertion Open Badges come expires.
Che cosa vede un verificatore
È la parte più importante, perché una data di scadenza che nessuno controlla è solo decorazione.
Ogni conferimento ha una pagina di verifica pubblica su https://badges.ninja/awards/<awardId>, visibile senza registrarsi. La pagina confronta la data di scadenza con la data odierna a ogni caricamento:
- Prima della data di scadenza: la pagina mostra la credenziale come valida e visualizza una riga “valida fino al” con la data.
- Dopo la data di scadenza: la pagina passa a un avviso “Scaduta il” con la data. La credenziale è ancora lì, quindi la cronologia resta intatta, ma nessuno può scambiarla per una credenziale attuale.
- Se la credenziale è stata revocata: la revoca ha la precedenza sulla scadenza. Una credenziale revocata appare come revocata, non semplicemente come scaduta.
I verificatori automatici ottengono le stesse informazioni dal documento JSON-LD Open Badge v2.0 all’indirizzo https://api.badges.ninja/certify-badge/award/<awardId>, dove l’assertion contiene il campo expires. Qualsiasi strumento che legga lo standard può applicare la propria policy. Un sistema HR può rifiutare del tutto una credenziale scaduta, mentre un elenco di ex studenti può mostrarla come “già certificato”.
La credenziale porta la data anche all’esterno. Il pulsante “Add to LinkedIn” sul conferimento compila mese e anno di scadenza nella voce di certificazione di LinkedIn, così il profilo della persona riflette la stessa data di decadenza che hai impostato. Anche il certificato PDF scaricabile riporta una data “Expires” accanto alla data di rilascio.
Una conseguenza da dire chiaramente: la scadenza viene valutata nel momento in cui qualcuno guarda, non da un job eseguito da te. Non devi fare nulla il giorno in cui una credenziale decade. Nulla viene “spento”: la pagina di verifica si limita a dire la verità sulla data.
Vedere che cosa sta per scadere
I programmi che gestiscono i rinnovi hanno bisogno di un elenco di chi è in scadenza. La pagina dei conferimenti nella dashboard ha una colonna Expires con la data di ogni credenziale, e aprendo una credenziale compare un banner: Active, Expires on una data, oppure Expired on una data.

Per una campagna di rinnovo, la strada più semplice è selezionare le righe che ti interessano e usare Export CSV. L’esportazione include una colonna “Valid To”. Aprila in un foglio di calcolo, ordina per quella colonna e in circa un minuto hai la pipeline dei rinnovi del prossimo trimestre.
Dobbiamo essere onesti su un limite: al momento la piattaforma non invia da sola email automatiche del tipo “la tua credenziale sta per scadere” ai destinatari. Considera il promemoria un passaggio del tuo processo. Uno schema comune è un appuntamento in calendario il primo giorno di ogni mese: esporti il CSV, filtri le date dei prossimi 60-90 giorni e invii a quelle persone le istruzioni per il rinnovo dal tuo normale strumento di posta. Per la maggior parte dei programmi con qualche centinaio di credenziali bastano dieci minuti al mese, molto meno lavoro che costruire un sistema di notifiche.
Se vuoi davvero automatizzarlo, l’endpoint dell’elenco dei conferimenti (GET /awards) restituisce le credenziali in pagine da 50, e ogni record include la scadenza. Uno script pianificato che scorre l’elenco e scrive a chi scade entro 60 giorni è un piccolo progetto. Ma prova prima il foglio di calcolo e automatizza solo quando il passaggio manuale diventa davvero un peso.
Modelli di rinnovo
Quando qualcuno rinnova, che cosa dovrebbe succedere alla credenziale? Ci sono tre modelli ragionevoli, e quello giusto dipende da come è definito il tuo programma di certificazione.
Modello 1: rilasciare un nuovo conferimento (consigliato)
È l’approccio più pulito. La persona completa il richiamo o l’esame di ricertificazione, e tu rilasci un nuovo conferimento dallo stesso badge con una nuova data di rilascio e una nuova data di scadenza. Ora ha due credenziali con lo stesso badge: la vecchia, che risulta scaduta, e la nuova, che risulta attiva.
Perché di solito è la scelta giusta:
- Ogni credenziale registra una cronologia onesta: rilasciata in questa data, valida fino a quest’altra.
- Il vecchio URL pubblico continua a funzionare e continua a dire “scaduta”, il che è corretto. Nessuno che lo abbia salvato tra i preferiti viene tratto in inganno.
- Il nuovo conferimento ha il proprio URL di verifica, il proprio certificato PDF e la propria voce Add to LinkedIn. La persona può sostituire la vecchia voce di LinkedIn o tenerle entrambe per mostrare una certificazione continua.
- I tuoi report possono contare i rinnovi semplicemente contando i conferimenti per destinatario per un badge.
Per mantenere il collegamento tra vecchio e nuovo, indicalo nei criteri del badge o nei tuoi registri. Un badge di ricertificazione può dire “Rinnovo di Formazione annuale sulla sicurezza, valido dopo aver completato il richiamo”. Se ti serve un collegamento rigido nel tuo sistema, salva insieme i valori awardId vecchio e nuovo nel tuo database di formazione o HR quando rilasci quello nuovo.
Modello 2: modificare la scadenza sul posto (solo prima dell’invio)
La piattaforma permette di modificare una credenziale sul posto, ma solo finché non è stata inviata per email e non è stata revocata. In questa finestra puoi correggere nome del destinatario, email, data di rilascio o data di scadenza senza cambiare l’URL del conferimento. Serve a correggere errori, come una data di scadenza sbagliata digitata in fase di configurazione, non a prorogare una credenziale che qualcuno possiede già.
Una volta che la credenziale è stata inviata per email al destinatario, è bloccata. Se devi cambiarla dopo, la strada supportata è revocarla e rilasciarne una nuova. Il che ci porta al terzo modello.
Modello 3: revocare e rilasciare di nuovo
Usalo quando la credenziale non dovrebbe più essere considerata valida in assoluto, ad esempio la persona ha perso la licenza a metà mandato, oppure l’hai rilasciata con il badge sbagliato. Non è il normale percorso di rinnovo, perché la revoca invia un segnale più forte della scadenza: dice che la credenziale non avrebbe dovuto essere considerata affidabile, non semplicemente che il suo periodo è terminato. La nostra guida passo passo su come revocare un Open Badge spiega quando usare l’una o l’altra.
Una buona regola pratica: la scadenza significa che il periodo è finito; la revoca significa che qualcosa non andava. Non revocare le credenziali solo perché sono decadute. Lasciale scadere e conserva la traccia.
Scegliere un periodo di validità
Le date di scadenza sono decisioni di policy, e sbagliarle crea veri mal di testa. Alcune indicazioni dai programmi che vediamo funzionare bene:
| Tipo di credenziale | Validità tipica | Note |
|---|---|---|
| Certificazione di cybersecurity o IT | Da 2 a 3 anni | Strumenti e minacce cambiano in fretta |
| Formazione annuale sulla sicurezza | 12 mesi | Spesso legata a un obbligo normativo |
| Primo soccorso e BLS | 2 anni | Segui la regola del tuo ente regolatore, non una consuetudine |
| Credito di formazione continua | Fine del ciclo di rendicontazione | Allinealo al ciclo così i rinnovi si raggruppano |
| Completamento di un corso | Nessuna scadenza | Il completamento è un fatto; ometti expires |
Due consigli pratici. Primo, allinea le date di scadenza a un ritmo di calendario dove puoi. Se tutti in una coorte decadono nella stessa data, il rinnovo diventa una sola campagna invece di cinquanta. Secondo, non mettere una scadenza su credenziali che sono in realtà registrazioni di completamento. Un badge che dice “ha partecipato alla conferenza 2025” non diventa meno vero l’anno prossimo, e una data di scadenza non fa che creare confusione.
Un esempio concreto: una certificazione di sicurezza biennale
Mettiamo tutto insieme per un team di formazione che gestisce una certificazione di sensibilizzazione alla sicurezza per un’azienda di 400 dipendenti.
- Progetta il badge una volta sola nel designer visuale. Dagli un nome, imposta i criteri (superare l’esame con un punteggio dell’80 percento o superiore) e descrivi il periodo di validità nella descrizione, così i destinatari sanno a che cosa si stanno iscrivendo.
- Rilascia con una scadenza. Dopo ogni sessione d’esame, carica l’elenco degli idonei tramite i conferimenti in blocco con la scadenza impostata a due anni. Ogni persona riceve la propria email con il link di verifica, il certificato PDF e il pulsante Add to LinkedIn.
- Controlla ogni mese. Il primo del mese, esporta l’elenco dei conferimenti, ordina per “Valid To” ed estrai chi scade nei prossimi 90 giorni.
- Invitali a rinnovare. Invia a queste persone il link all’esame di ricertificazione dal tuo normale strumento di posta.
- Rilascia il rinnovo. Quando qualcuno supera l’esame, rilascia un nuovo conferimento dallo stesso badge con una nuova scadenza di due anni. Quello vecchio risulta scaduto da solo; non fare nulla.
- Rispondi agli auditor con un link. Quando la compliance chiede se una persona è attualmente certificata, invii l’URL di verifica. Mostra lo stato attuale senza che tu debba controllare niente.
Nessun software su misura, nessun cron job, nessuna migrazione. È questo il punto: la gestione del ciclo di vita è soprattutto questione di scegliere date sensate e avere un’abitudine mensile.
Errori comuni
- Impostare una scadenza su tutto. Riservala alle credenziali il cui significato svanisce davvero. Altrimenti crei lavoro di rinnovo senza alcun beneficio.
- Confondere scadenza e revoca. Revocare le credenziali decadute distrugge la cronologia della certificazione continua e fa sembrare la persona mai stata valida.
- Dimenticare il fuso orario. La data che scegli diventa un istante nel tempo. Se una norma dice “valido fino alla fine di marzo”, imposta la scadenza all’ultimo giorno di marzo o al primo di aprile, a seconda di come si legge la tua policy, e sii coerente.
- Pianificare di modificare invece di rilasciare di nuovo. La modifica è disponibile solo prima che la credenziale venga inviata per email. Pianifica i rinnovi come nuovi conferimenti fin dall’inizio.
- Nessun processo di promemoria. Poiché gli avvisi di scadenza non sono automatici, l’abitudine deve essere tua. Metti l’esportazione mensile nel calendario di qualcuno.
Dove andare dopo
Se le tue credenziali verranno controllate da altri sistemi, vale la pena leggere come è strutturato il documento che contiene expires: l’esempio commentato di JSON-LD per Open Badge percorre ogni campo di un’assertion. E se stai valutando se continuare a pagare una piattaforma per credenziale per tutto questo, il nostro confronto con l’alternativa a Credly illustra i costi.
Pronto a rilasciare la tua prima credenziale verificabile? Inizia gratis su badges.ninja — designer visuale, pagina di verifica pubblica, certificato PDF, output Open Badge v2.0. Nessuna carta di credito richiesta.
Come è stato realizzato questo articolo
Alcuni articoli di questo blog vengono redatti con l'aiuto di un assistente IA e poi revisionati, verificati e modificati dal team di Badges Ninja prima della pubblicazione. Ogni esempio di codice e ogni prezzo viene verificato rispetto al prodotto live. Scopri di più sul nostro processo editoriale e sull'uso dell'IA nella nostra pagina sul processo editoriale .

Informazioni sull'autore
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.
Altri articoli di Nacho Coll
- Open Badges per i bootcamp di coding: emettere credenziali verificabili su scala di coorte19 nov 2026 · 12min di lettura
- Configurare i webhook per gli eventi dei badge: integrazione in tempo reale con il tuo backend16 nov 2026 · 9min di lettura
- Open Badge Baking spiegato: come il JSON vive dentro il PNG9 nov 2026 · 12min di lettura


