Criar token

Descrição

Endpoint para autenticação de usuários na API. Permite que usuários façam login e recebam um token JWT válido por 30 dias para acessar recursos protegidos.

📋 Detalhes da Requisição

URL

POST https://seudominio.com/api/auth

Headers Obrigatórios

Body da Requisição (JSON)

{
  "username": "string",
  "password": "string"
}

Parâmetros

Campo	Tipo	Obrigatório	Descrição
`username`	string	✅ Sim	Email ou nome de usuário
`password`	string	✅ Sim	Senha do usuário

📤 Respostas da API

✅ Sucesso (200 OK)

{
  "success": true,
  "message": "Login realizado com sucesso",
  "data": {
    "user": {
      "nome": "João",
      "sobrenome": "Silva",
      "email": "joao@exemplo.com"
    },
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX2xldmVsIjoxLCJpYXQiOjE3NjEzNjAzMDAsImV4cCI6MTc2Mzk1MjMwMH0.qQ3aDwRsvYH5N4z21JjyBaO0BWRuO4Hwmck2IdCIX2s",
    "expires_in": 2592000
  }
}

❌ Erro - Credenciais Inválidas (401 Unauthorized)

{
  "success": false,
  "message": "Credenciais inválidas",
  "error": "Unauthorized"
}

❌ Erro - Dados Inválidos (400 Bad Request)

{
  "success": false,
  "message": "Dados de validação",
  "errors": {
    "username": "Campo obrigatório",
    "password": "Mínimo 7 caracteres"
  }
}

❌ Erro - JSON Inválido (400 Bad Request)

{
  "success": false,
  "message": "Dados JSON inválidos",
  "error": "Bad Request"
}

⚠️ Códigos de Status HTTP

Código	Descrição	Quando Ocorre
`200`	Success	Login realizado com sucesso
`400`	Bad Request	Dados inválidos ou JSON malformado
`401`	Unauthorized	Credenciais inválidas
`500`	Internal Server Error	Erro interno do servidor

application/json

Body

Exemplo

{
    "success": true,
    "message": "string",
    "data": {
        "user": {
            "nome": "string",
            "sobrenome": "string",
            "email": "string"
        },
        "token": "string",
        "expires_in": 0
    },
    "timestamp": "string",
    "status_code": 0
}

Descrição#

📋 Detalhes da Requisição#

URL#

Headers Obrigatórios#

Body da Requisição (JSON)#

Parâmetros#

📤 Respostas da API#

✅ Sucesso (200 OK)#

❌ Erro - Credenciais Inválidas (401 Unauthorized)#

❌ Erro - Dados Inválidos (400 Bad Request)#

❌ Erro - JSON Inválido (400 Bad Request)#

⚠️ Códigos de Status HTTP#

Requisição

Exemplos de Requisição

Respostas

Descrição

📋 Detalhes da Requisição

URL

Headers Obrigatórios

Body da Requisição (JSON)

Parâmetros

📤 Respostas da API

✅ Sucesso (200 OK)

❌ Erro - Credenciais Inválidas (401 Unauthorized)

❌ Erro - Dados Inválidos (400 Bad Request)

❌ Erro - JSON Inválido (400 Bad Request)

⚠️ Códigos de Status HTTP