Endpoints

Endpoint:
/Auth

Gerencie autenticação via JWT, API Keys e OTP para compradores. Suporte a múltiplos métodos de auth para diferentes casos de uso.

Última AtualizaçãoMAR 2026
POST/v1/auth/register

Criar conta

Registra um novo usuário e organização. Retorna um JWT token válido por 24h.

Parâmetros

CampoTipoObrigatórioDescrição
namestringOBRIGATÓRIONome completo
emailstringOBRIGATÓRIOEmail
passwordstringOBRIGATÓRIOSenha (mín 8 chars)
{
  "name": "João Silva",
  "email": "joao@empresa.com",
  "password": "MinhaSenh@Forte123"
}
Resposta
201 Created
{
  "token": "eyJhbGciOiJSUzI1NiIs...",
  "expires_in": 86400,
  "token_type": "Bearer",
  "user": {
    "id": "550e8400-e29b-41d4-...",
    "name": "João Silva",
    "email": "joao@empresa.com"
  }
}
POST/v1/auth/login

Login

Autentica um usuário existente e retorna um JWT token.

Parâmetros

CampoTipoObrigatórioDescrição
emailstringOBRIGATÓRIOEmail cadastrado
passwordstringOBRIGATÓRIOSenha
{
  "email": "joao@empresa.com",
  "password": "MinhaSenh@Forte123"
}
Resposta
200 OK
{
  "token": "eyJhbGciOiJSUzI1NiIs...",
  "expires_in": 86400,
  "token_type": "Bearer"
}
POST/v1/api-keys

Criar API Key

Gera uma API Key para integração programática. A chave completa só é mostrada UMA VEZ — guarde com segurança. Use o header X-API-Key.

Parâmetros

CampoTipoObrigatórioDescrição
namestringOBRIGATÓRIONome da integração
{
  "name": "Minha Integração"
}
Resposta
201 Created
{
  "id": "...",
  "key": "sk_live_aBcDeFgHiJkLm...",
  "prefix": "sk_live_aBcD",
  "name": "Minha Integração"
}
POST/v1/auth/request-otp

Solicitar OTP

Envia um código OTP de 6 dígitos por email para autenticação de compradores.

Parâmetros

CampoTipoObrigatórioDescrição
emailstringOBRIGATÓRIOEmail do comprador
{ "email": "cliente@email.com" }
Resposta
200 OK
{ "message": "OTP sent" }
POST/v1/auth/verify-otp

Verificar OTP

Valida o código OTP e cria uma sessão com cookie httpOnly.

Parâmetros

CampoTipoObrigatórioDescrição
emailstringOBRIGATÓRIOEmail
codestringOBRIGATÓRIOCódigo de 6 dígitos
{
  "email": "cliente@email.com",
  "code": "123456"
}
Resposta
200 OK
{ "session": "created" }

Pronto para escalar?

Nossa infraestrutura global processa milhões de requisições simultâneas em horários de pico. Junte-se a +500 promotores usando Flair.

99.9%

Uptime Garantido

API
terminalAPI Sandbox
api.flair.api.br
Flair