API Reference

🔐 Autenticação

Todas as requisições da API Pública exigem um token de autenticação exclusivo da plataforma. Esse token garante que apenas sistemas autorizados possam interagir com os dados daquela plataforma.


📥 Como obter o token

  1. Acesse o painel administrativo da sua plataforma.
  2. Vá até Configurações > Plaraforma > Chaves de autenticação.
  3. Clique em "Gerar novo token" (caso ainda não exista ou deseje renovar).
  4. Salve-o em um local seguro.
⚠️

Importante: Ao gerar um novo token, o anterior é imediatamente invalidado.


📤 Como usar o token

Inclua o token no cabeçalho de todas as requisições, utilizando o formato Bearer:

Authorization: Bearer {seu_token}

Exemplo:

POST /public/api/v1/users
Host: sua-plataforma.ensinio.cloud
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5...
Content-Type: application/json

🔒 Segurança e boas práticas

  • O token é único por plataforma e deve ser tratado como uma credencial secreta.
  • Nunca compartilhe o token em repositórios públicos, ferramentas de terceiros ou arquivos expostos.
  • Sempre use HTTPS para consumir a API.