Open Badge: utgångsdatum och förnyelse – livscykelhantering för tidsbegränsade meriter
Fortbildningspoäng, certifieringar och licenser löper alla ut. Sätt expirationDate på Open Badges och förnya dem programmatiskt. Schema + arbetsflöde.
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.
Vissa meriter gäller för livet. En examen slutar inte vara sann för att det har gått tio år. Men en stor del av de meriter som utbildningsteam utfärdar är raka motsatsen: en tvåårig certifiering i cybersäkerhet, en årlig repetitionskurs i truckkörning, ett HLR-kort, ett fortbildningspoäng som bara gäller under en rapporteringsperiod. De här meriterna är ett påstående om att någon var kompetent vid ett visst datum, och påståendet har ett bäst före-datum.
Om dina digitala meriter aldrig löper ut säger du i tysthet något som inte stämmer till arbetsgivare och revisorer. Den här artikeln går igenom hur utgångsdatum fungerar i Open Badges, vad en verifierare ser när en merit har gått ut och ett praktiskt förnyelseflöde som inte kräver att du skriver kod om du inte vill.
En notering om namn innan vi börjar
Många söker efter “expirationDate”. I specifikationen Open Badges v2.0 heter fältet på en assertion (själva tilldelningen, till skillnad från badge-klassen) expires. Det är en ISO 8601-sträng med datum och tid. API-fältet du skickar när du utfärdar en merit på https://badges.ninja heter också expires. Samma idé, men ett annat namn än de flesta gissar, så ha det i åtanke när du läser ett JSON-LD-dokument eller söker i dokumentationen.
Två detaljer värda att känna till:
- Utgångsdatumet hör till tilldelningen, inte till märket. Samma märke (säg “Annual Safety Training”) kan utfärdas till en person med utgång i mars och till en annan med utgång i september. Det är precis vad du vill, eftersom giltigheten räknas från när var och en slutförde utbildningen.
- Det är valfritt. Utelämnar du det går meriten aldrig ut.
Sätta ett utgångsdatum vid utfärdande
Du har tre sätt att ange en giltighetstid. Börja med de två första, eftersom de inte kräver någon kod.
Formuläret i instrumentpanelen. När du skapar en merit har formuläret ett valfritt datumfält “Expires” bredvid mottagarens namn och e-post. Välj datum och utfärda. Det är hela jobbet.

Massutdelning. Om du utfärdar till en hel kull tar sidan för massutdelning en CSV med mottagare och tillämpar ett enda utgångsdatum på hela satsen, så att en klass som blev klar samma vecka får samma utgångsdatum. Du kan pausa och återuppta en stor sats. Vår genomgång av att utfärda Open Badges från en CSV beskriver filformatet.
API:et. För automatisering, till exempel en koppling i ett lärplattformssystem som utfärdar en merit när någon klarar provet, lägg till expires i kroppen på POST /awards. Det accepterar samma format som issuedOn: epok-millisekunder eller en ISO-datumsträng.
// 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}`;
Samma anrop i 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
Mottagarens namn måste vara minst fem tecken, issuedOn är obligatoriskt och ett lyckat anrop returnerar HTTP 200 med { awardId }. Verifierings-URL:en finns inte i svaret; du bygger den från id:t som visas ovan. Hela förfrågningskontraktet finns i API-referensen för awards.
Bakom kulisserna normaliserar plattformen det du skickar till en ISO 8601-sträng och lagrar den i Open Badges-assertionen som expires.
Vad en verifierare ser
Det här är den viktigaste delen, för ett utgångsdatum som ingen kontrollerar är bara dekoration.
Varje tilldelning har en offentlig verifieringssida på https://badges.ninja/awards/<awardId>, och ingen registrering krävs för att se den. Sidan jämför utgångsdatumet med dagens datum varje gång den läses in:
- Före utgångsdatumet: sidan visar meriten som giltig och visar en rad “valid until” med datumet.
- Efter utgångsdatumet: sidan växlar till ett meddelande “Expired on” med datumet. Meriten finns kvar, så historiken är intakt, men ingen kan ta den för en aktuell.
- Om meriten har återkallats: återkallelse går före utgång. En återkallad merit visas som återkallad, inte bara som utgången.
Maskinella verifierare får samma information från JSON-LD-dokumentet för Open Badge v2.0 på https://api.badges.ninja/certify-badge/award/<awardId>, där assertionen innehåller fältet expires. Alla verktyg som läser standarden kan tillämpa sin egen policy. Ett HR-system kan avvisa en utgången merit rakt av, medan en alumnkatalog kan visa den som “tidigare certifierad”.
Meriten för också datumet vidare. Knappen “Add to LinkedIn” på tilldelningen fyller i utgångsmånad och utgångsår i LinkedIn-certifieringen, så att personens profil speglar samma utgångsdatum som du satte. Det nedladdningsbara PDF-certifikatet skriver också ut ett “Expires”-datum bredvid utfärdandedatumet.
En konsekvens värd att säga rakt ut: utgång utvärderas i det ögonblick någon tittar, inte av ett jobb som körs hos dig. Du behöver inte göra något den dag en merit går ut. Ingenting “stängs av”; verifieringssidan berättar helt enkelt sanningen om datumet.
Se vad som snart går ut
Program som följer förnyelser behöver en lista över vem som närmar sig sin tur. Sidan med tilldelningar i instrumentpanelen har en kolumn Expires som visar varje merits datum, och när du öppnar en merit visas ett fält: Active, Expires on ett datum eller Expired on ett datum.

För en förnyelsekampanj är det enklaste att markera raderna du bryr dig om och använda Export CSV. Exporten innehåller en kolumn “Valid To”. Öppna den i ett kalkylblad, sortera på den kolumnen, så har du en förnyelsepipeline för nästa kvartal på ungefär en minut.
Vi ska vara ärliga om en begränsning: plattformen skickar för närvarande inte automatiska e-postmeddelanden av typen “din merit går snart ut” till mottagarna på egen hand. Behandla påminnelsen som ett steg i din egen process. Ett vanligt mönster är en kalenderpost den första i varje månad: exportera CSV:n, filtrera på datum inom de kommande 60–90 dagarna och skicka dina förnyelseinstruktioner till de personerna från ditt vanliga e-postverktyg. För de flesta program med några hundra meriter tar det tio minuter i månaden och är betydligt mindre arbete än att bygga ett aviseringssystem.
Vill du ändå automatisera returnerar listendpointen för tilldelningar (GET /awards) dina meriter i sidor om 50, och varje post innehåller sitt utgångsdatum. Ett schemalagt skript som går igenom listan och mejlar alla som går ut inom 60 dagar är ett litet projekt. Men prova kalkylbladet först och automatisera bara när det manuella steget faktiskt gör ont.
Förnyelsemönster
När någon förnyar, vad ska hända med meriten? Det finns tre rimliga mönster, och det rätta beror på hur ditt certifieringsprogram är definierat.
Mönster 1: utfärda en ny tilldelning (rekommenderas)
Det här är det renaste tillvägagångssättet. Personen slutför repetitionskursen eller omcertifieringsprovet, och du utfärdar en ny tilldelning från samma märke med nytt utfärdandedatum och nytt utgångsdatum. Personen har nu två meriter med samma märke: den gamla, som visas som utgången, och den nya, som visas som aktiv.
Varför det oftast är rätt:
- Varje merit registrerar en ärlig historik: utfärdad detta datum, giltig till det datumet.
- Den gamla offentliga URL:en fortsätter fungera och fortsätter säga “expired”, vilket är korrekt. Ingen som bokmärkt den vilseleds.
- Den nya tilldelningen får sin egen verifierings-URL, sitt eget PDF-certifikat och sin egen Add to LinkedIn-post. Personen kan ersätta den gamla LinkedIn-posten eller behålla båda för att visa kontinuerlig certifiering.
- Dina rapporter kan räkna förnyelser helt enkelt genom att räkna tilldelningar per mottagare för ett märke.
För att behålla kopplingen mellan gammal och ny kan du skriva in den i märkets kriterier eller i dina egna register. Ett omcertifieringsmärke kan säga “Renewal of Annual Safety Training, valid after completing the refresher.” Behöver du en hård koppling i ditt eget system, lagra de gamla och nya awardId-värdena tillsammans i din lärplattforms- eller HR-databas när du utfärdar den nya.
Mönster 2: redigera utgångsdatumet på plats (bara innan den skickats)
Plattformen stöder redigering av en merit på plats, men bara så länge den inte har skickats med e-post och inte har återkallats. Inom det fönstret kan du rätta mottagarens namn, e-post, utfärdandedatum eller utgångsdatum utan att ändra tilldelningens URL. Det är till för att rätta misstag, till exempel ett felaktigt utgångsdatum som skrevs in vid uppsättningen, inte för att förlänga en merit som någon redan innehar.
När en merit har skickats med e-post till mottagaren är den låst. Behöver du ändra den efter det är den stödda vägen att återkalla den och utfärda en ny. Det för oss till det tredje mönstret.
Mönster 3: återkalla och utfärda på nytt
Använd detta när meriten inte längre alls ska anses giltig, till exempel att personen förlorade sin licens mitt i perioden, eller att du utfärdade den med fel märke. Det är inte den normala förnyelsevägen, eftersom en återkallelse skickar en starkare signal än utgång: den säger att meriten inte borde ha litats på, inte bara att dess period tog slut. Vår steg-för-steg-guide om att återkalla en Open Badge beskriver när vilken är lämplig.
En bra tumregel: utgång betyder att perioden tog slut; återkallelse betyder att något var fel. Återkalla inte meriter bara för att de gått ut. Låt dem löpa ut och behåll registret.
Välja giltighetstid
Utgångsdatum är policybeslut, och om du gör fel skapar det verkliga huvudbry. Några råd från program vi ser fungera bra:
| Meritens typ | Typisk giltighet | Anteckningar |
|---|---|---|
| Certifiering i cybersäkerhet eller IT | 2–3 år | Verktyg och hot förändras snabbt |
| Årlig säkerhetsutbildning | 12 månader | Ofta kopplad till ett regulatoriskt krav |
| Första hjälpen och HLR | 2 år | Följ tillsynsmyndighetens regel, inte en konvention |
| Fortbildningspoäng | Slutet av rapporteringsperioden | Anpassa efter perioden så att förnyelserna samlas |
| Kursavslut | Inget utgångsdatum | Avslut är ett faktum; utelämna expires |
Två praktiska tips. För det första: anpassa utgångsdatum till en kalenderrytm där du kan. Om alla i en kull går ut samma datum blir förnyelsen en enda kampanj i stället för femtio. För det andra: sätt inget utgångsdatum på meriter som egentligen är register över avslutade moment. Ett märke som säger “deltog i konferensen 2025” blir inte mindre sant nästa år, och ett utgångsdatum på det skapar bara förvirring.
Ett genomarbetat exempel: en tvåårig säkerhetscertifiering
Låt oss sätta ihop det hela för ett utbildningsteam som kör en certifiering i säkerhetsmedvetenhet för ett företag med 400 anställda.
- Designa märket en gång i den visuella designern. Ge det ett namn, ange kriterierna (klara provet med minst 80 procent) och beskriv giltighetstiden i beskrivningen så att mottagarna vet vad de ger sig in på.
- Utfärda med utgångsdatum. Efter varje provtillfälle laddar du upp listan över godkända via massutdelning med utgångsdatumet satt två år fram. Varje person får sitt e-postmeddelande med verifieringslänken, PDF-certifikatet och knappen Add to LinkedIn.
- Kontrollera varje månad. Den första i månaden exporterar du listan över tilldelningar, sorterar på “Valid To” och plockar ut alla som går ut inom 90 dagar.
- Bjud in dem att förnya. Skicka dem länken till omcertifieringsprovet från ditt vanliga e-postverktyg.
- Utfärda förnyelsen. När någon klarar provet utfärdar du en ny tilldelning från samma märke med ett nytt tvåårigt utgångsdatum. Den gamla visas som utgången av sig själv; gör ingenting med den.
- Svara revisorer med en länk. När regelefterlevnad frågar om en person är certifierad just nu skickar du verifierings-URL:en. Den visar aktuell status utan att du behöver kontrollera något.
Ingen skräddarsydd programvara, inga cron-jobb, inga migreringar. Det är poängen: livscykelhantering handlar mest om att välja vettiga datum och ha en månatlig vana.
Vanliga misstag
- Att sätta utgångsdatum på allt. Spara det för meriter vars betydelse verkligen bleknar. Annars skapar du förnyelsearbete utan nytta.
- Att blanda ihop utgång och återkallelse. Att återkalla utgångna meriter förstör historiken över kontinuerlig certifiering och får personen att se ut som att aldrig ha varit giltig.
- Att glömma tidszonen. Datumet du väljer blir en tidpunkt. Om en förordning säger “giltigt till och med slutet av mars”, sätt utgången till sista dagen i mars eller första dagen i april, beroende på hur din policy lyder, och var konsekvent.
- Att planera för redigering i stället för nyutfärdande. Redigering är bara möjlig innan meriten skickats med e-post. Planera förnyelser som nya tilldelningar från början.
- Ingen påminnelseprocess. Eftersom utgångsaviseringar inte är automatiserade måste vanan vara din. Lägg den månatliga exporten i någons kalender.
Vart du går härnäst
Om dina meriter ska kontrolleras av andra system är det värt att läsa hur dokumentet som bär expires är uppbyggt: genomgången av ett Open Badge JSON-LD-exempel går igenom varje fält i en assertion. Och om du funderar på om du ska fortsätta betala en plattform per merit för allt detta visar vår jämförelse med Credly-alternativet kostnaderna.
Redo att utfärda din första verifierbara merit? Kom igång gratis på badges.ninja — visuell designer, offentlig verifieringssida, PDF-certifikat, Open Badge v2.0-utdata. Inget kreditkort krävs.
Så här skapades artikeln
Vissa inlägg på den här bloggen skrivs med hjälp av en AI-assistent och granskas, faktakontrolleras och redigeras därefter av Badges Ninja-teamet före publicering. Varje kodexempel och pris kontrolleras mot den faktiska produkten. Läs mer om vår redaktionella process och AI-process på vår sida om redaktionell process .

Om författaren
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.


