Ir para o conteúdo

API de Autenticação

Esta API é responsável por autenticar os usuários no sistema e gerar o token de acesso (JWT) necessário para consumir os recursos protegidos.

1. Realizar Login

Este método autentica um usuário com base em seu login e password e, em caso de sucesso, retorna um token de acesso.

Endpoint: 

POST /auth/login

Parâmetros de Rota: Nenhum.

Corpo da Requisição (application/json): O corpo da requisição deve conter as credenciais (login e password) do usuário.

Exemplo de Requisição:

{
  "login": "admin",
  "password": "a_senha_do_usuario"
}

Exemplo de Resposta (200 OK): A resposta contém o token de acesso que deve ser usado nas requisições subsequentes.

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

Códigos de Status:

  • 200 OK: Autenticação bem-sucedida e token gerado.
  • 400 Bad Request: Dados faltando no corpo da requisição (ex: sem login ou password).
  • 401 Unauthorized: Credenciais inválidas (login ou senha incorretos).