Expiração e renovação de Open Badges: gestão do ciclo de vida de credenciais com prazo de validade

Créditos de educação continuada, certificações e licenças expiram. Defina expirationDate nos Open Badges e renove-os de forma programática. Esquema + fluxo de trabalho.

Nacho Coll Por Atualizado 12 min de leitura
Créditos de educação continuada, certificações e licenças expiram. Defina expirationDate nos Open Badges e renove-os de forma programática. Esquema + fluxo de trabalho.

Algumas credenciais são para a vida toda. Um diploma não deixa de ser verdadeiro só porque se passaram dez anos. Mas uma grande parte das credenciais emitidas pelas equipes de treinamento é justamente o contrário: uma certificação de cibersegurança de dois anos, uma reciclagem anual de segurança com empilhadeiras, um cartão de RCP, um crédito de educação continuada válido apenas para um ciclo de relatório. Essas credenciais afirmam que alguém era competente em determinada data, e essa afirmação tem prazo de validade.

Se as suas credenciais digitais nunca expiram, você está dizendo em silêncio a empregadores e auditores algo que não é verdade. Este artigo explica como a expiração funciona nos Open Badges, o que um verificador vê quando uma credencial vence e um fluxo de renovação prático que não exige escrever código, a menos que você queira.

Uma observação sobre nomes antes de começar

Você vai ver gente pesquisando por “expirationDate”. Na especificação Open Badges v2.0, o campo de uma asserção (a concessão em si, em oposição à classe do emblema) se chama expires. É uma string de data e hora ISO 8601. O campo da API que você envia ao emitir uma credencial em https://badges.ninja também se chama expires. É a mesma ideia com um nome diferente do que a maioria imagina, então tenha isso em mente ao ler um documento JSON-LD ou pesquisar na documentação.

Dois detalhes que vale saber:

  • A expiração vive na concessão, não no emblema. O mesmo emblema (digamos, “Annual Safety Training”) pode ser emitido para uma pessoa com vencimento em março e para outra com vencimento em setembro. É isso que você quer, porque a validade é contada a partir de quando cada pessoa concluiu o treinamento.
  • É opcional. Se você a omitir, a credencial nunca expira.

Definindo a expiração ao emitir

Você tem três formas de definir um período de validade. Comece pelas duas primeiras, que não precisam de código.

O formulário do painel. Ao criar uma credencial, o formulário tem um campo opcional “Expires” ao lado do nome e do e-mail do destinatário. Escolha a data e emita. É só isso.

New Award form

Concessões em massa. Se você vai emitir para uma turma inteira, a página de concessões em massa aceita um CSV de destinatários e aplica uma única data de expiração ao lote, de modo que uma turma que terminou na mesma semana vence na mesma data. Você pode pausar e retomar um lote grande. Nosso passo a passo sobre como emitir Open Badges a partir de um CSV cobre o formato do arquivo.

A API. Para automação, como um hook de um sistema de gestão de aprendizagem que emite uma credencial quando alguém passa na prova, adicione expires ao corpo de POST /awards. Ele aceita os mesmos formatos de issuedOn: milissegundos epoch ou uma string 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}`;

A mesma chamada em 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

O nome do destinatário deve ter pelo menos cinco caracteres, issuedOn é obrigatório e uma chamada bem-sucedida retorna HTTP 200 com { awardId }. A URL de verificação não vem na resposta; você a monta a partir do id, como mostrado. O contrato completo da requisição está na referência da API de awards.

Por baixo dos panos, a plataforma normaliza o que você enviar para uma string ISO 8601 e a armazena na asserção do Open Badges como expires.

O que o verificador vê

Esta é a parte que mais importa, porque uma data de expiração que ninguém confere é só decoração.

Cada concessão tem uma página pública de verificação em https://badges.ninja/awards/<awardId>, que pode ser vista sem cadastro. A página compara a data de expiração com a data de hoje a cada carregamento:

  • Antes da data de expiração: a página mostra a credencial como válida e exibe uma linha “valid until” com a data.
  • Depois da data de expiração: a página muda para um aviso “Expired on” com a data. A credencial continua lá, então o histórico fica intacto, mas ninguém a confunde com uma vigente.
  • Se a credencial foi revogada: a revogação tem precedência sobre a expiração. Uma credencial revogada aparece como revogada, não apenas como expirada.

Verificadores automáticos obtêm a mesma informação do documento JSON-LD do Open Badge v2.0 em https://api.badges.ninja/certify-badge/award/<awardId>, onde a asserção traz o campo expires. Qualquer ferramenta que leia o padrão pode aplicar sua própria política. Um sistema de RH pode recusar de cara uma credencial expirada, enquanto um diretório de ex-alunos pode exibi-la como “anteriormente certificado”.

A credencial também leva a data para fora. O botão “Add to LinkedIn” na concessão preenche o mês e o ano de expiração na entrada de certificação do LinkedIn, para que o perfil da pessoa reflita a mesma data de vencimento que você definiu. O certificado em PDF para download também imprime uma data “Expires” ao lado da data de emissão.

Uma consequência que vale dizer com clareza: a expiração é avaliada no momento em que alguém consulta, não por um job que roda do seu lado. Você não precisa fazer nada no dia em que uma credencial vence. Nada é “desligado”; a página de verificação simplesmente diz a verdade sobre a data.

Vendo o que está prestes a vencer

Programas que acompanham renovações precisam de uma lista de quem está chegando perto de renovar. A página de concessões do painel tem uma coluna Expires mostrando a data de cada credencial, e abrir uma credencial exibe um banner: Active, Expires on uma data ou Expired on uma data.

Awards list

Para uma campanha de renovação, o caminho mais fácil é selecionar as linhas que interessam e usar Export CSV. A exportação inclui uma coluna “Valid To”. Abra em uma planilha, ordene por essa coluna e você terá o pipeline de renovações do próximo trimestre em cerca de um minuto.

Vamos ser honestos sobre um limite: a plataforma atualmente não envia por conta própria e-mails automáticos de “sua credencial vence em breve” aos destinatários. Trate o lembrete como uma etapa do seu próprio processo. Um padrão comum é um evento de calendário no primeiro dia de cada mês: exporte o CSV, filtre as datas dos próximos 60 a 90 dias e envie a essas pessoas as instruções de renovação pela sua ferramenta de e-mail habitual. Para a maioria dos programas com algumas centenas de credenciais, isso leva dez minutos por mês e dá muito menos trabalho do que construir um sistema de notificações.

Se você quiser automatizar mesmo assim, o endpoint de listagem de concessões (GET /awards) retorna suas credenciais em páginas de 50, e cada registro inclui a expiração. Um script agendado que percorre a lista e envia e-mail a quem vence em até 60 dias é um projeto pequeno. Mas experimente a planilha primeiro e só automatize quando a etapa manual realmente incomodar.

Padrões de renovação

Quando alguém renova, o que deve acontecer com a credencial? Há três padrões razoáveis, e o certo depende de como o seu programa de certificação é definido.

Padrão 1: emitir uma nova concessão (recomendado)

Esta é a abordagem mais limpa. A pessoa conclui a reciclagem ou a prova de recertificação, e você emite uma nova concessão do mesmo emblema com uma nova data de emissão e uma nova data de expiração. Agora ela tem duas credenciais com o mesmo emblema: a antiga, que aparece como expirada, e a nova, que aparece como ativa.

Por que isso costuma ser o certo:

  • Cada credencial registra um histórico honesto: emitida nesta data, válida até aquela.
  • A URL pública antiga continua funcionando e continua dizendo “expirada”, o que é correto. Ninguém que a tenha salvado nos favoritos é induzido a erro.
  • A nova concessão tem sua própria URL de verificação, certificado em PDF e entrada de Add to LinkedIn. A pessoa pode substituir a entrada antiga do LinkedIn ou manter as duas para mostrar certificação contínua.
  • Seus relatórios podem contar renovações simplesmente contando concessões por destinatário para um emblema.

Para manter o vínculo entre a antiga e a nova, registre-o nos critérios do emblema ou nos seus próprios registros. Um emblema de recertificação pode dizer “Renovação de Annual Safety Training, válida após concluir a reciclagem”. Se você precisa de um vínculo firme no seu próprio sistema, armazene juntos os valores awardId antigo e novo no seu banco de dados de aprendizagem ou de RH ao emitir o novo.

Padrão 2: editar a expiração no próprio registro (só antes do envio)

A plataforma permite editar uma credencial no próprio registro, mas apenas enquanto ela não tiver sido enviada por e-mail e não tiver sido revogada. Dentro dessa janela, você pode corrigir o nome do destinatário, o e-mail, a data de emissão ou a data de expiração sem mudar a URL da concessão. Serve para corrigir erros, como uma data de expiração digitada errada na configuração, não para estender uma credencial que alguém já possui.

Depois que a credencial é enviada por e-mail ao destinatário, ela fica bloqueada. Se precisar alterá-la depois disso, o caminho suportado é revogá-la e emitir uma nova. Isso nos leva ao terceiro padrão.

Padrão 3: revogar e reemitir

Use quando a credencial não deve mais ser considerada válida de forma alguma, por exemplo, se a pessoa perdeu a licença no meio do prazo ou se você a emitiu com o emblema errado. Não é o caminho normal de renovação, porque a revogação envia um sinal mais forte do que a expiração: diz que a credencial não deveria ter sido considerada confiável, não apenas que o seu prazo acabou. Nosso passo a passo sobre como revogar um Open Badge explica quando cada um é apropriado.

Uma boa regra prática: expiração significa que o prazo acabou; revogação significa que algo estava errado. Não revogue credenciais só porque venceram. Deixe-as expirar e mantenha o registro.

Escolhendo um período de validade

Datas de expiração são decisões de política, e errar nelas gera dor de cabeça de verdade. Algumas orientações de programas que vemos funcionando bem:

Tipo de credencialValidade típicaObservações
Certificação de cibersegurança ou TI2 a 3 anosFerramentas e ameaças mudam rápido
Treinamento anual de segurança12 mesesFrequentemente ligado a uma exigência regulatória
Primeiros socorros e RCP2 anosSiga a regra do seu órgão regulador, não uma convenção
Crédito de educação continuadaFim do ciclo de relatórioAlinhe ao ciclo para que as renovações sejam agrupadas
Conclusão de cursoSem expiraçãoConclusão é um fato; deixe expires de fora

Duas dicas práticas. Primeiro, alinhe as datas de expiração a um ritmo de calendário sempre que puder. Se todos de uma turma vencem na mesma data, a renovação vira uma campanha só em vez de cinquenta. Segundo, não coloque expiração em credenciais que na verdade são registros de conclusão. Um emblema que diz “participou da conferência de 2025” não fica menos verdadeiro no ano que vem, e uma data de expiração nele só gera confusão.

Um exemplo completo: uma certificação de segurança de dois anos

Juntando tudo no caso de uma equipe de treinamento que mantém uma certificação de conscientização em segurança para uma empresa de 400 funcionários.

  1. Projete o emblema uma única vez no designer visual. Dê um nome, defina os critérios (passar na prova com nota de 80 por cento ou mais) e descreva o período de validade na descrição para que os destinatários saibam no que estão se inscrevendo.
  2. Emita com expiração. Após cada sessão de prova, envie a lista de aprovados por concessões em massa com a expiração definida para dois anos à frente. Cada pessoa recebe o e-mail com o link de verificação, o certificado em PDF e o botão Add to LinkedIn.
  3. Confira todo mês. No primeiro dia do mês, exporte a lista de concessões, ordene por “Valid To” e separe todos que vencem nos próximos 90 dias.
  4. Convide-os a renovar. Envie a essas pessoas o link da prova de recertificação pela sua ferramenta de e-mail habitual.
  5. Emita a renovação. Quando alguém passar, emita uma nova concessão do mesmo emblema com uma nova expiração de dois anos. A antiga aparece como expirada por conta própria; não faça nada com ela.
  6. Responda aos auditores com um link. Quando a área de conformidade perguntar se uma pessoa está certificada no momento, você envia a URL de verificação. Ela mostra o status atual sem que você precise conferir nada.

Sem software sob medida, sem cron jobs, sem migrações. Esse é o ponto: a gestão do ciclo de vida é, na maior parte, escolher datas sensatas e ter um hábito mensal.

Erros comuns

  • Colocar expiração em tudo. Reserve para credenciais cujo significado realmente se desgasta. Caso contrário, você cria trabalho de renovação sem nenhum benefício.
  • Confundir expiração com revogação. Revogar credenciais vencidas destrói o histórico de certificação contínua e faz a pessoa parecer nunca ter sido válida.
  • Esquecer o fuso horário. A data que você escolhe vira um ponto no tempo. Se uma norma diz “válido até o fim de março”, defina a expiração para o último dia de março ou o primeiro de abril, conforme a leitura da sua política, e seja consistente.
  • Planejar editar em vez de reemitir. A edição só está disponível antes de a credencial ser enviada por e-mail. Planeje as renovações como novas concessões desde o início.
  • Nenhum processo de lembrete. Como os avisos de expiração não são automáticos, o hábito precisa ser seu. Coloque a exportação mensal na agenda de alguém.

Para onde ir a seguir

Se as suas credenciais vão ser verificadas por outros sistemas, vale a pena ler como é estruturado o documento que carrega expires: o passo a passo de um exemplo de Open Badge JSON-LD percorre cada campo de uma asserção. E se você está avaliando se continua pagando a uma plataforma por credencial por tudo isso, nossa comparação de alternativas ao Credly detalha os custos.

Pronto para emitir sua primeira credencial verificável? Comece de graça em badges.ninja — designer visual, página pública de verificação, certificado em PDF, saída Open Badge v2.0. Não é necessário cartão de crédito.

Nacho Coll

Sobre o 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.

Voltar ao Blog

Artigos Relacionados