Validar certificado de treinamento

Todo certificado de conclusão de curso emitido pelos Treinamentos (LMS) da TAI traz um código (e um QR code) que qualquer pessoa confere sem login: o cliente que exige a NR em dia, o auditor, o recrutador de outra empresa, um sistema que recebeu o certificado.

Quando usar	Conferir se um certificado apresentado é autêntico, está válido e não foi revogado
Porta	Página pública (sem token)
Você vai precisar	Só o código impresso no certificado

Como funciona

certificado (PDF, papel) ─► código / QR code
        │
        ▼
GET /lms/certificados/{codigo}/validar
   Accept: application/json  ──► dados do certificado
   Accept: text/html         ──► página de validação (destino do QR code)

Consultar

GET /lms/certificados/{codigo}/validar
Accept: application/json

{
  "codigo": "…",
  "colaboradorNome": "Ana Ribeiro",
  "cursoTitulo": "Segurança no trabalho",
  "empresaNome": "…",
  "cargaHoraria": 8,
  "notaFinal": 9.5,
  "dataEmissao": "2026-09-12 10:00:00",
  "dataValidade": null,
  "valido": true,
  "revogado": false,
  "expirado": false
}

Campo	Significado
valido	true quando o certificado não foi revogado e não passou da validade
revogado	O certificado foi cancelado por quem gere os treinamentos
expirado	dataValidade já passou — comum em reciclagens obrigatórias
dataValidade	null quando o certificado não vence

Um código inexistente responde 404. Com Accept: text/html, a mesma rota devolve a página de validação — é para onde aponta o QR code impresso no certificado.

Cuidados

• Olhe valido, não só o 200. Um certificado revogado ou vencido existe e responde 200; o que diz se ele vale hoje é valido.
• Datas chegam no horário de Brasília, no formato yyyy-MM-dd HH:mm:ss — veja Datas e formatos.
• O PDF do certificado não é público: GET /lms/certificados/{id}/download exige login (a própria pessoa ou quem gere os certificados). Veja a referência de Treinamentos.