Plantonizei

Autenticação

Cookie de sessão, segunda etapa e de onde sai a empresa.

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çãoDuração
Login comum12 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

RespostaQuando
401 {"error": "e-mail ou senha inválidos"}Credencial errada. A mensagem é a mesma para e-mail que não existe.
401 com "mfaRequired": trueA 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.
429Muitas 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.

Nesta página