Endpoint: Autenticação

Visão Geral

O endpoint de autenticação permite obter um token JWT para acessar os demais endpoints da API.

Base URL: https://api.imobileai.com.br/auth

Endpoints Disponíveis

1. Login

POST /auth

Corpo da Requisição

{
    "email": "seu_email",
    "password": "sua_senha"
}

Exemplo de Resposta

{
    "success": true,
    "data": {
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "user": {
            "id": 1,
            "name": "Nome do Usuário",
            "email": "seu_email",
            "role": "LOJISTA",
            "is_active": true,
            "subscription_end": "2025-01-01",
            "store": {
                "id": 1,
                "name": "Nome da Loja"
            }
        }
    }
}

2. Validar Token

GET /auth/validate

Headers

Authorization: Bearer seu_token_jwt

Exemplo de Resposta

{
    "success": true,
    "data": {
        "valid": true,
        "user": {
            "id": 1,
            "name": "Nome do Usuário",
            "email": "seu_email",
            "role": "LOJISTA",
            "is_active": true,
            "subscription_end": "2025-01-01"
        }
    }
}

Erros

Código Descrição
400 Email ou senha não fornecidos
401 Credenciais inválidas
403 Usuário inativo ou assinatura expirada
500 Erro interno do servidor

Observações

  • O token JWT tem validade de 7 dias
  • O token deve ser enviado no header Authorization em todas as requisições
  • O campo role pode ser: SUPER_ADMIN ou LOJISTA
  • Usuários inativos ou com assinatura expirada não podem fazer login
  • Todos os campos de texto são retornados com encoding UTF-8

Uso no n8n

1. Obter Token

{
    "node": "HTTP Request",
    "parameters": {
        "method": "POST",
        "url": "https://api.imobileai.com.br/auth",
        "headers": {
            "Content-Type": "application/json"
        },
        "body": {
            "email": "seu_email",
            "password": "sua_senha"
        }
    }
}

2. Validar Token

{
    "node": "HTTP Request",
    "parameters": {
        "method": "GET",
        "url": "https://api.imobileai.com.br/auth/validate",
        "headers": {
            "Authorization": "Bearer {{$node['Auth'].json['data']['token']}}"
        }
    }
}

Dicas

  • Armazene o token em uma variável para reutilizar em outras requisições
  • Valide o token antes de fazer requisições para outros endpoints
  • Renove o token antes que expire para manter a sessão ativa