Saltar para o conteúdo principal

​
POST /auth/login

Autentique-se com as suas credenciais de API e receba um access_token e um refresh_token.
Este endpoint não requer autenticação.

​
Corpo do pedido

ParâmetroTipoObrigatórioDescrição
emailstringSimO endereço de e-mail da sua conta
passwordstringSimA palavra-passe da sua conta

​
Pedido

curl -X POST https://api.dokstamp.eu/auth/login \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "admin@myschool.edu",
    "password": "your_password"
  }'

​
Resposta 200

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...",
  "refresh_token": "def50200a9c4b...",
  "token_type": "Bearer",
  "expires_in": 31536000
}
CampoTipoDescrição
access_tokenstringToken JWT a incluir no cabeçalho Authorization: Bearer {token}
refresh_tokenstringToken utilizado para obter um novo par via POST /auth/refresh
token_typestringSempre "Bearer"
expires_inintegerValidade em segundos (31 536 000 ≈ 1 ano)

​
Erro 401

{ "message": "These credentials do not match our records." }

​
Erro 422

{
  "message": "The given data was invalid.",
  "errors": {
    "email": ["The email field is required."],
    "password": ["The password field is required."]
  }
}