Autenticação
Cookie de sessão, segunda etapa e de onde sai a empresa.
A sessão é um cookie
O login devolve o cookie pl_session: opaco, HttpOnly e sem nenhum dado dentro. Mande-o em todo pedido. O token do provedor de identidade nunca sai do servidor.
| Situação | Duração |
|---|---|
| Login comum | 12 horas |
Login com keepSignedIn: true ("Manter conectado") | 30 dias |
POST /api/v1/auth/logout encerra a sessão no servidor, e não só no aparelho.
O que pode dar errado no login
| Resposta | Quando |
|---|---|
401 {"error": "e-mail ou senha inválidos"} | Credencial errada. A mensagem é a mesma para e-mail que não existe. |
401 com "mfaRequired": true | A senha conferiu e falta o código da segunda etapa. Repita o login com code. |
403 com "code": "EMAIL_NAO_CONFIRMADO" | Autocadastro com o e-mail ainda não confirmado. |
429 | Muitas tentativas seguidas. Espere alguns minutos. |
Quatro tipos de sessão
- Empresa: gestor, coordenador ou outro perfil do painel. As rotas do painel respeitam o perfil de permissão (sem permissão,
403). - Médico: o vínculo do médico com uma empresa. Médico em mais de uma empresa troca com
POST /api/v1/me/empresas/{linkId}/entrar, sem sair. - Sem empresa: quem se cadastrou e ainda não foi aprovado, ou saiu de todas as empresas. Só alcança o próprio cadastro (
/me/cadastro,/me/empresas). - Equipe da plataforma: as rotas de
/api/v1/admin.
A empresa vem da sessão
Nenhuma rota recebe a empresa na URL ou no corpo: ela é sempre a da sessão. Isso impede ler ou escrever dado de outra empresa trocando um id.