Autenticação

A API do Falcon Finanças utiliza tokens JWT no padrão Bearer.

Login

POST /api/v1/auth/login

O corpo deve conter o e-mail e a senha fornecidos para a integração:

{
  "email": "[e-mail]",
  "password": "sua-senha"
}

Exemplo de resposta:

{
  "success": true,
  "message": "Login Realizado com sucesso",
  "data": {
    "accessToken": "eyJ...",
    "refreshToken": "eyJ...",
    "expiresAt": "2026-08-04T18:00:00Z"
  }
}

Token Bearer

Envie accessToken nas rotas protegidas:

Authorization: Bearer eyJ...

O token identifica o parceiro. Por isso, a API retorna somente clientes e planos vinculados ao parceiro autenticado.

Cuidados de segurança

• Armazene credenciais e tokens em um gerenciador de segredos.

• Não grave senhas ou tokens completos em logs.

• Não envie tokens por parâmetros de URL.

• Renove a autenticação quando o token de acesso expirar.

• Em caso de suspeita de vazamento, solicite imediatamente a troca das credenciais.

Nunca inclua credenciais reais em exemplos, tickets de suporte ou repositórios Git.