šŸ” AuthController - bbarrosomoreira/digital-bank-api GitHub Wiki

šŸ“„ PT-BR | EN-US


šŸ‡§šŸ‡· AuthController – Descrição

Este controller é responsÔvel por registrar novos usuÔrios e realizar login no sistema. Tanto após o registro (signin) quanto o login, um token JWT é gerado e deve ser usado como Authorization: Bearer {token} em todas as demais requisições autenticadas.


šŸ‡ŗšŸ‡ø AuthController – Description

This controller is responsible for registering new users and logging in to the system. After signing in or logging in, a JWT token is generated and must be used as Authorization: Bearer {token} in all subsequent authenticated requests.


šŸ“„ Endpoints

Método Endpoint Acesso Descrição (PT-BR) Description (EN-US)
POST /auth/signin PÚBLICO Registra um novo usuÔrio e retorna o token (login automÔtico) Registers a new user and returns the token (auto login)
POST /auth/login PÚBLICO Autentica o usuÔrio e retorna o token Authenticates user and returns the token

🧾 Regras

  • Os usuĆ”rios podem se registrar como CLIENTE ou ADMIN.
  • O token JWT retornado deve ser incluĆ­do no cabeƧalho de autorização para acessar os demais endpoints.

šŸ“Œ Exemplos (JSON)

Registro de UsuƔrio

Requisição:

POST /auth/signin
Content-Type: application/json

{
    "email": "[email protected]",
    "senha": "123456",
    "role": "CLIENTE"
}

Resposta:

{
    "token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkZXZAZ21haWwuY29tIiwiaWF0IjoxNzQ1NTQyMjIzLCJleHAiOjE3NDU1NDk0MjN9.5ElJ3CLrMF_SABEontXqXAVIQfhb4wp5BbbJ4pdGS48"
}