Autenticação
Início de sessão, renovação de token, reposição de palavra-passe, conclusão de SSO – e acesso à API com chaves de API.
Este grupo abrange a autenticação de utilizadores: início de sessão com endereço de e-mail ou nome de utilizador e palavra-passe, renovação da sessão através de um token de atualização, reposição de uma palavra-passe esquecida e conclusão de um início de sessão único (SAML/OIDC). Os endpoints devolvem um token de acesso (JWT), enviado no cabeçalho `Authorization: Bearer <token>`, e um token de atualização que é substituído por um novo em cada utilização.
Para o acesso automatizado dos seus próprios programas aos seus dados, utilize uma chave de API para a API REST em `https://zentor-app.de/api/v1` em vez de um início de sessão de utilizador. A Zentor ativa o acesso à API mediante pedido; em seguida, os administradores criam no painel, em «Chaves de API», chaves com permissões definidas (scopes). A chave é transmitida no cabeçalho `Authorization: Bearer <chave de API>` ou em `X-API-Key`. Encontra os scopes, os códigos de erro e recomendações sobre o armazenamento seguro na visão geral da referência da API.
Os endpoints de autenticação estão protegidos contra tentativas falhadas repetidas: após várias entradas incorretas, o servidor atrasa as tentativas seguintes e bloqueia-as temporariamente com 429 `RATE_LIMIT_EXCEEDED`.