Gastometria Logo
API Docs
v1
Voltar
Recursos da API
  • Autenticação
    5
  • Carteiras
    6
  • Transações
    6
  • Orçamentos
    5
  • Metas
    6
  • Parcelamentos
    6
  • Relatórios
    2
  • Categorias
    3
  • Configurações
    2
  • Créditos IA
    3
  • Workspaces
    5
  • Gamificação
    2
  • Regras de Comerciante
    4
  • Permissões
    2
  • Anomalias
    2
  • Recorrências
    2
  • Transações Inteligentes
    1
  • Inteligência Artificial
    1
  • Recibos e Notas Fiscais
    2

Autenticação

5 endpoints disponívelis

Autenticar usuário e obter tokens JWT. O access token expira em 15 minutos, use /refresh para renová-lo. Requer conta com plano Infinity ativo.

Testar Endpoint
Request Body

E-mail cadastrado na conta Gastometria. Exemplo: usuario@email.com

Senha da conta. Mínimo 6 caracteres. A senha é transmitida de forma segura via HTTPS

Exemplo de Requisição
{
  "email": "usuario@email.com",
  "password": "sua_senha_aqui"
}
Exemplo de Resposta
{
  "user": {
    "id": "...",
    "email": "usuario@email.com",
    "name": "Nome",
    "plan": "Infinity",
    "image": "https://..."
  },
  "tokens": {
    "accessToken": "eyJhbGc...",
    "refreshToken": "eyJhbGc...",
    "expiresIn": 900
  }
}
Possíveis Erros

Renovar o access token usando o refresh token. Use este endpoint quando o access token expirar (15 min). O refresh token expira em 7 dias.

Testar Endpoint
Request Body

Refresh token JWT obtido na resposta do endpoint /login. Válido por 7 dias

Exemplo de Requisição
{
  "refreshToken": "eyJhbGc..."
}
Exemplo de Resposta
{
  "accessToken": "eyJhbGc...",
  "user": {
    "id": "...",
    "email": "...",
    "plan": "Infinity"
  },
  "expiresIn": 900
}

Obter informações completas do usuário autenticado, incluindo plano, créditos de IA e dados do perfil.

Testar Endpoint
Autenticação necessária
Exemplo de Resposta
{
  "user": {
    "id": "abc123",
    "email": "usuario@email.com",
    "name": "Nome Completo",
    "image": "https://lh3.googleusercontent.com/...",
    "plan": "Infinity",
    "aiCredits": 100,
    "createdAt": "2024-01-15T10:30:00Z"
  }
}

Enviar e-mail de recuperação de senha. O usuário receberá um link para redefinir a senha.

Testar Endpoint
Request Body

E-mail da conta para recuperação

Exemplo de Requisição
{
  "email": "usuario@email.com"
}
Exemplo de Resposta
{
  "success": true,
  "message": "Password reset email sent if account exists"
}

Gerar token de autenticação web temporário. Usado para autenticação entre web app e integrações externas.

Testar Endpoint
Autenticação necessária
Request Body

Propósito do token (ex: 'whatsapp_integration')

Tempo de expiração em segundos (padrão: 3600)

Exemplo de Requisição
{
  "purpose": "whatsapp_integration",
  "expiresIn": 7200
}
Exemplo de Resposta
{
  "token": "wt_abc123xyz...",
  "expiresAt": "2024-12-14T14:00:00Z",
  "purpose": "whatsapp_integration"
}

© 2026 Gastometria - API v1

Base URL: /api/v1