Tokens da API de integração

A API de integração conecta os sistemas da sua organização (RH, ERP, BI) à Eduvem: cadastro e matrícula automáticos, extração de relatórios, download de certificados e mais. Todo acesso acontece por tokens criados pelo administrador.

Criando e gerenciando tokens

Crie vários tokens nomeados e independentes - um por sistema integrado é a boa prática. Cada um pode ser revogado sem afetar os demais.
O valor do token é exibido uma única vez, na criação. Guarde-o no cofre de segredos da sua organização: se for perdido, o caminho é excluir o token e criar outro.
Alguns dados exigem permissão extra concedida no token: download de certificados, o histórico de auditoria de matrículas e os relatórios. Conceda só o que a integração realmente usa.

O que a integração faz

Cadastro e atualização de participantes (individual e em lote), gestão de grupos e papéis, matrículas e mudanças de estado (aprovar, negar, cancelar, reativar), listagem e download de certificados em PDF, relatórios (resumo por sala e exportação por matrícula), catálogo de salas e conteúdos, e o ranking.

Na matrícula via API, o participante pode ser identificado por e-mail ou CPF - se ainda não existe, o cadastro é criado automaticamente.

Auditoria

Toda escrita feita pela API fica registrada (o quê, quando e com qual token) e o histórico de chamadas pode ser consultado pelo administrador - você sempre sabe o que cada sistema externo fez.

Limites de uso

O tráfego é limitado por instituição (orçamento padrão na casa de 1.000 a 2.000 requisições por minuto, ajustável sob demanda).
Operações pesadas (exportações de auditoria/relatórios e download de certificados) têm um orçamento próprio, menor - um pico nelas não trava o restante da integração.
Listagens são paginadas (padrão 100 itens por página, máximo 1.000): oriente os integradores a sempre paginar.