01. 🔐 Autenticação

Autenticação e controle de acesso Sistema de autenticação OAuth2 com tokens JWT para acesso seguro à API. Recursos disponíveis:

• Autenticação OAuth2 com Bearer tokens

• Tokens sem expiração automática

• Controle de sessões de usuário

• Integração com aplicações externas

Autenticação OAuth2

post

Endpoint principal para autenticação na API Maino

Implementa o protocolo OAuth2 para gerar tokens JWT de acesso à API. Este endpoint é o ponto de entrada para todas as integrações e deve ser usado antes de acessar qualquer outro recurso protegido da API.

Pré-requisitos:

• Application UID fornecido pela equipe Maino

• Credenciais válidas de usuário no sistema

• Usuário deve ter permissões de API ativadas

Fluxo de autenticação:

1. Envie application_uid, email e password

2. Sistema valida as credenciais e permissões

3. Retorna dados da empresa e tokens de acesso

4. Use o access_token como Bearer Token em outras requisições

Características do token:

• Validade: 24 horas

• Formato: JWT (JSON Web Token)

• Escopo: Acesso completo à API conforme permissões do usuário

• Renovação: Usar refresh_token para renovar sem nova autenticação

Segurança:

• Tokens são únicos por usuário e aplicação

• Dados sensíveis nunca são armazenados no token

• Controle de IP e rate limiting aplicados

• Auditoria completa de tentativas de login

Corpo

application/json

application_uidstring · uuidObrigatório

UUID único da aplicação fornecido pela Maino

Example: 7be75d8c-6bb5-4749-9cf1-cc181073520b

emailstring · emailObrigatório

Email do usuário cadastrado no sistema

Example: [email protected]

passwordstring · passwordObrigatório

Senha do usuário

Example: senhaSegura123!

Respostas

200

Autenticação realizada com sucesso

Autenticação bem-sucedidaapplication/json

401

Falha na autenticação

post

/authentication

HTTPcURLJavaScriptPython

POST /api/v2/authentication HTTP/1.1
Host: api.maino.com.br
Content-Type: application/json
Accept: */*
Content-Length: 120

{
  "application_uid": "7be75d8c-6bb5-4749-9cf1-cc181073520b",
  "email": "[email protected]",
  "password": "senhaSegura123!"
}

{
  "value": {
    "12345670000101": {
      "email": "[email protected]",
      "user_name": "João Silva",
      "company_name": "EMPRESA EXEMPLO LTDA",
      "cnpj": "12345670000101",
      "access_token": "A2_GpUn5M-T6btyI4CFmaapnvaRc3Gyu1sbTFn-k3o",
      "refresh_token": "f5pS7RHvG_0xDmUJQIaKslv5B3wGmoP4lf_Fjsap"
    }
  }
}