Caducitat i renovació dels Open Badges: gestió del cicle de vida de les credencials amb termini
Els crèdits de formació contínua, les certificacions i les llicències caduquen. Defineix expirationDate als Open Badges i renova'ls per programa. Esquema + flux de treball.
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.
Algunes credencials són per a tota la vida. Un títol universitari no deixa de ser cert perquè hagin passat deu anys. Però una bona part de les credencials que emeten els equips de formació són just el contrari: una certificació de ciberseguretat de dos anys, un reciclatge anual de seguretat amb carretons elevadors, un carnet de RCP, un crèdit de formació contínua que només és vàlid durant un cicle d’informes. Aquestes credencials afirmen que algú era competent en una data concreta, i aquesta afirmació té data de caducitat.
Si les teves credencials digitals no caduquen mai, estàs dient en silenci a empreses i auditors alguna cosa que no és certa. Aquest article explica com funciona la caducitat als Open Badges, què veu un verificador quan una credencial caduca i un flux de renovació pràctic que no t’obliga a escriure codi, tret que vulguis.
Una nota sobre el nom abans de començar
Hi ha gent que cerca «expirationDate». A l’especificació Open Badges v2.0, el camp d’una asserció (el lliurament en si, no la classe d’insígnia) es diu expires. És una cadena de data i hora ISO 8601. El camp de l’API que envies en emetre una credencial a https://badges.ninja també es diu expires. És la mateixa idea amb un nom diferent del que la majoria s’imagina, així que tingues-ho present quan llegeixis un document JSON-LD o cerquis a la documentació.
Dos detalls que convé saber:
- La caducitat viu a l’atorgament, no a la insígnia. La mateixa insígnia (posem «Formació anual de seguretat») es pot emetre a una persona amb caducitat al març i a una altra amb caducitat al setembre. És el que vols, perquè la validesa es compta des que cadascú va completar la formació.
- És opcional. Si no l’indiques, la credencial no caduca mai.
Definir la caducitat en emetre
Tens tres maneres de fixar un període de validesa. Comença per les dues primeres, que no requereixen codi.
El formulari del tauler. Quan crees una credencial, el formulari té un camp opcional «Caduca» al costat del nom i el correu del destinatari. Tria la data i emet. Ja està.

Atorgaments en bloc. Si emets per a tota una cohort, la pàgina d’atorgaments en bloc accepta un CSV de destinataris i aplica una única data de caducitat a tot el lot, de manera que un grup que ha acabat la mateixa setmana té la mateixa data de venciment. Pots aturar i reprendre un lot gran. La nostra guia sobre emetre Open Badges des d’un CSV explica el format del fitxer.
L’API. Per a l’automatització, per exemple un hook d’un sistema de gestió de l’aprenentatge que emet una credencial quan algú aprova l’examen, afegeix expires al cos de POST /awards. Accepta els mateixos formats que issuedOn: mil·lisegons d’època o una cadena de 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 mateixa crida en 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
El nom del destinatari ha de tenir almenys cinc caràcters, issuedOn és obligatori i una crida reeixida retorna HTTP 200 amb { awardId }. L’URL de verificació no és a la resposta; la construeixes a partir de l’identificador, tal com es mostra. El contracte complet de la petició és a la referència de l’API d’atorgaments.
Internament, la plataforma normalitza el que enviïs a una cadena ISO 8601 i la desa a l’asserció d’Open Badges com a expires.
Què veu un verificador
Aquesta és la part que més importa, perquè una data de caducitat que ningú comprova és pura decoració.
Cada atorgament té una pàgina pública de verificació a https://badges.ninja/awards/<awardId>, i no cal registrar-s’hi per veure-la. La pàgina compara la data de caducitat amb la d’avui cada vegada que es carrega:
- Abans de la data de caducitat: la pàgina mostra la credencial com a vàlida i hi afegeix una línia «vàlida fins al» amb la data.
- Després de la data de caducitat: la pàgina passa a mostrar un avís «Caducada el» amb la data. La credencial hi continua, així que l’historial es manté, però ningú pot confondre-la amb una de vigent.
- Si la credencial s’ha revocat: la revocació preval sobre la caducitat. Una credencial revocada es mostra com a revocada, no simplement com a caducada.
Els verificadors automàtics reben la mateixa informació del document JSON-LD d’Open Badge v2.0 a https://api.badges.ninja/certify-badge/award/<awardId>, on l’asserció porta el camp expires. Qualsevol eina que llegeixi l’estàndard pot aplicar la seva pròpia política. Un sistema de recursos humans pot rebutjar sense contemplacions una credencial caducada, mentre que un directori d’exalumnes pot mostrar-la com a «anteriorment certificat».
La credencial també porta la data cap a fora. El botó «Add to LinkedIn» de l’atorgament emplena el mes i l’any de caducitat a l’entrada de certificació de LinkedIn, de manera que el perfil de la persona reflecteix la mateixa data de venciment que has fixat. El certificat PDF descarregable també imprimeix una data «Expires» al costat de la data d’emissió.
Una conseqüència que convé dir clarament: la caducitat s’avalua en el moment en què algú mira, no per cap tasca que s’executi pel teu compte. No has de fer res el dia que una credencial venç. No s’«apaga» res; la pàgina de verificació simplement diu la veritat sobre la data.
Veure què està a punt de caducar
Els programes que fan seguiment de renovacions necessiten una llista de qui s’acosta a la data de renovació. La pàgina d’atorgaments del tauler té una columna Expires amb la data de cada credencial, i en obrir una credencial apareix un bàner: Active, Expires on una data, o Expired on una data.

Per a una campanya de renovació, el camí més fàcil és seleccionar les files que t’interessen i fer servir Export CSV. L’exportació inclou una columna «Valid To». Obre-la en un full de càlcul, ordena per aquesta columna i tindràs el flux de renovacions del proper trimestre en cosa d’un minut.
Hem de ser sincers sobre un límit: la plataforma no envia actualment correus automàtics de tipus «la teva credencial caduca aviat» als destinataris. Considera el recordatori un pas del teu propi procés. Un patró habitual és una entrada al calendari el primer de cada mes: exportar el CSV, filtrar les dates dels propers 60 a 90 dies i enviar a aquestes persones les instruccions de renovació des de la teva eina de correu habitual. Per a la majoria de programes amb unes quantes centenes de credencials, això porta deu minuts al mes i és molta menys feina que construir un sistema de notificacions.
Si vols automatitzar-ho, el punt final de llista d’atorgaments (GET /awards) retorna les teves credencials en pàgines de 50, i cada registre inclou la seva caducitat. Un script programat que reculli la llista i enviï un correu a qui caduqui en els propers 60 dies és un projecte petit. Però prova primer amb el full de càlcul i automatitza només quan el pas manual de debò faci nosa.
Patrons de renovació
Quan algú renova, què ha de passar amb la credencial? Hi ha tres patrons raonables, i el correcte depèn de com estigui definit el teu programa de certificació.
Patró 1: emetre un atorgament nou (recomanat)
És l’enfocament més net. La persona completa el reciclatge o l’examen de recertificació, i tu emets un atorgament nou de la mateixa insígnia amb una data d’emissió nova i una data de caducitat nova. Ara té dues credencials de la mateixa insígnia: l’antiga, que apareix com a caducada, i la nova, que apareix com a activa.
Per què sol ser l’opció encertada:
- Cada credencial registra un historial honest: emesa en aquesta data, vàlida fins a aquesta altra.
- L’URL públic antic continua funcionant i continua dient «caducada», que és exacte. Ningú que l’hagi desat als adreces d’interès no es veu induït a error.
- El nou atorgament té el seu propi URL de verificació, certificat PDF i entrada d’Add to LinkedIn. La persona pot substituir l’entrada antiga de LinkedIn o conservar-les totes dues per mostrar una certificació contínua.
- Els teus informes poden comptar renovacions simplement comptant atorgaments per destinatari i insígnia.
Per mantenir el vincle entre l’antiga i la nova, deixa-ho escrit als criteris de la insígnia o als teus registres. Una insígnia de recertificació pot dir «Renovació de la Formació anual de seguretat, vàlida després de completar el reciclatge». Si necessites un vincle ferm al teu propi sistema, desa junts els valors awardId de l’antic i del nou a la teva base de dades de gestió de l’aprenentatge o de recursos humans quan emetis el nou.
Patró 2: editar la caducitat in situ (només abans de l’enviament)
La plataforma permet editar una credencial in situ, però només mentre no s’ha enviat per correu i no s’ha revocat. Dins d’aquesta finestra pots corregir el nom del destinatari, el correu, la data d’emissió o la de caducitat sense canviar l’URL de l’atorgament. Això és per corregir errors, com una data de caducitat mal escrita durant la configuració, no per allargar una credencial que algú ja té.
Quan una credencial s’ha enviat per correu al destinatari, queda bloquejada. Si l’has de canviar després, la via admesa és revocar-la i emetre’n una de nova. Això ens porta al tercer patró.
Patró 3: revocar i tornar a emetre
Fes-lo servir quan la credencial ja no s’hagi de considerar vàlida en cap cas, per exemple si la persona ha perdut la llicència a mitjan període o si l’has emesa amb la insígnia equivocada. No és el camí normal de renovació, perquè la revocació envia un senyal més fort que la caducitat: diu que la credencial no s’hauria d’haver considerat fiable, no pas simplement que el seu termini ha acabat. La nostra guia pas a pas sobre revocar un Open Badge explica quan convé cadascuna.
Una bona regla general: la caducitat vol dir que el termini ha acabat; la revocació vol dir que alguna cosa anava malament. No revoquis credencials només perquè hagin vençut. Deixa que caduquin i conserva el registre.
Triar un període de validesa
Les dates de caducitat són decisions de política, i encertar-les malament crea maldecaps reals. Alguns consells de programes que veiem funcionar bé:
| Tipus de credencial | Validesa típica | Notes |
|---|---|---|
| Certificació de ciberseguretat o TI | 2 a 3 anys | Les eines i les amenaces canvien de pressa |
| Formació anual de seguretat | 12 mesos | Sovint lligada a un requisit normatiu |
| Primers auxilis i RCP | 2 anys | Segueix la norma del teu regulador, no una convenció |
| Crèdit de formació contínua | Final del cicle d’informes | Alinea-ho amb el cicle perquè les renovacions es facin en bloc |
| Finalització d’un curs | Sense caducitat | La finalització és un fet; deixa expires sense indicar |
Dos consells pràctics. Primer, alinea les dates de caducitat amb un ritme de calendari sempre que puguis. Si tots els d’una cohort venen el mateix dia, la renovació passa a ser una sola campanya en lloc de cinquanta. Segon, no posis caducitat a credencials que en realitat són registres de finalització. Una insígnia que diu «va assistir a la conferència del 2025» no és menys certa l’any vinent, i una data de caducitat només crea confusió.
Un exemple pràctic: una certificació de seguretat de dos anys
Ho posem tot junt per a un equip de formació que gestiona una certificació de conscienciació en seguretat per a una empresa de 400 empleats.
- Dissenya la insígnia una sola vegada al dissenyador visual. Posa-li nom, defineix els criteris (aprovar l’examen amb una nota del 80 per cent o més) i descriu el període de validesa a la descripció perquè els destinataris sàpiguen a què s’apunten.
- Emet amb caducitat. Després de cada sessió d’examen, puja la llista d’aprovats mitjançant atorgaments en bloc amb la caducitat fixada a dos anys vista. Cada persona rep el seu correu amb l’enllaç de verificació, el certificat PDF i el botó Add to LinkedIn.
- Comprova-ho cada mes. El primer de mes, exporta la llista d’atorgaments, ordena per «Valid To» i recull tothom qui caduqui en els propers 90 dies.
- Convida’ls a renovar. Envia a aquestes persones l’enllaç de l’examen de recertificació des de la teva eina de correu habitual.
- Emet la renovació. Quan algú aprovi, emet un atorgament nou de la mateixa insígnia amb una caducitat nova de dos anys. L’antic apareix com a caducat per si sol; no hi has de fer res.
- Respon els auditors amb un enllaç. Quan compliment normatiu pregunti si una persona està certificada actualment, envies l’URL de verificació. Mostra l’estat actual sense que hagis de comprovar res.
Cap programari a mida, cap tasca cron, cap migració. Aquest és el punt: la gestió del cicle de vida és sobretot qüestió de triar dates assenyades i tenir un hàbit mensual.
Errors habituals
- Posar caducitat a tot. Reserva-la per a credencials el significat de les quals realment s’esvaeix. Si no, crees feina de renovació sense cap benefici.
- Confondre caducitat amb revocació. Revocar credencials vençudes destrueix l’historial de certificació contínua i fa que la persona sembli que mai no va ser vàlida.
- Oblidar la zona horària. La data que tries esdevé un instant en el temps. Si una normativa diu «vàlid fins a final de març», fixa la caducitat a l’últim dia de març, o al primer d’abril, segons com llegeixi la teva política, i sigues coherent.
- Plantejar-te editar en lloc de tornar a emetre. L’edició només és possible abans que la credencial s’enviï per correu. Planifica les renovacions com a atorgaments nous des del principi.
- Sense procés de recordatori. Com que els avisos de caducitat no són automàtics, l’hàbit l’has de tenir tu. Posa l’exportació mensual al calendari d’algú.
On anar a continuació
Si les teves credencials seran comprovades per altres sistemes, val la pena llegir com s’estructura el document que porta expires: l’explicació d’un exemple de JSON-LD d’Open Badge repassa cada camp d’una asserció. I si t’estàs plantejant si continues pagant una plataforma per credencial per tot això, la nostra comparativa d’alternatives a Credly detalla els costos.
Estàs a punt d’emetre la teva primera credencial verificable? Comença gratis a badges.ninja — dissenyador visual, pàgina pública de verificació, certificat PDF, sortida Open Badge v2.0. Sense targeta de crèdit.
Com es va fer aquest article
Alguns articles d'aquest blog es redacten amb l'ajuda d'un assistent d'IA i després són revisats, verificats i editats per l'equip de Badges Ninja abans de publicar-los. Cada mostra de codi i preu es verifica amb el producte real. Llegeix més sobre el nostre procés editorial i d'IA a la nostra pàgina del procés editorial .

Sobre l'autor
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.
Més de Nacho Coll
- Open Badges per a bootcamps de programació: emet credencials verificables a escala de promoció19 de nov. del 2026 · 13min de lectura
- Configurar webhooks per als esdeveniments d'insígnies: integració en temps real amb el teu backend16 de nov. del 2026 · 10min de lectura
- Open Badge Baking explicat: com viu el JSON dins del PNG9 de nov. del 2026 · 12min de lectura


