Aparência
Autenticação — Login e Sessão
Prefixo base: https://developer-api.fastgivr.com.br/access
Login, renovação e encerramento de sessão, e a autenticação alternativa via chave+documento (API-to-API).
POST /access/auth/login
Autentica o usuário e retorna um JWT.
Autenticação: Não requerida
Headers:
Content-Type: application/jsonBody:
json
{
"email": "usuario@exemplo.com",
"password": "senha123"
}| Campo | Tipo | Obrigatório | Regras |
|---|---|---|---|
email | string | Sim | e-mail válido |
password | string | Sim | mínimo 6 caracteres |
Response 200:
json
{
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
"token_type": "bearer",
"expires_in": 3600,
"user": {
"id": 1,
"name": "João Silva",
"email": "usuario@exemplo.com",
"document": "12345678901",
"phone": "11999999999",
"status": "active"
}
}Erros:
| Código | Descrição |
|---|---|
| 401 | Credenciais inválidas |
| 422 | Campos inválidos |
Regras de negócio:
- Se o login for feito de um IP/dispositivo novo, uma notificação de nova sessão é enviada ao usuário por e-mail.
POST /access/auth/logout
Encerra a sessão atual e invalida o token JWT.
Autenticação: Requerida (Authorization: Bearer {token})
Response 200:
json
{
"message": "Sessão encerrada com sucesso"
}Erros:
| Código | Descrição |
|---|---|
| 400 | Token ausente ou inválido |
PUT /access/auth/refresh
Renova o token JWT antes do vencimento.
Autenticação: Requerida
Response 200:
json
{
"token": "eyJ0eXAiOiJKV1Qi...",
"token_type": "bearer",
"expires_in": 3600,
"user": { ... }
}Sessões ativas
Cada login (/access/auth/login ou a 2ª etapa do 2FA) cria uma sessão e o token JWT leva o id dela no claim sid. A cada requisição autenticada a API confere a sessão: se ela foi encerrada ou expirou, responde 401. A última atividade e o IP são atualizados no máximo uma vez por minuto (ou na hora, se o IP mudar). logout encerra a sessão atual e refresh estende a validade dela.
Tokens de POST /access/account/get-token (integração) não criam sessão.
Localização: vem dos cabeçalhos do proxy (Cloudflare: CF-IPCity, CF-Region, CF-IPCountry; CloudFront: CloudFront-Viewer-City, CloudFront-Viewer-Country-Region-Name, CloudFront-Viewer-Country-Name). Com SESSION_GEOIP_DRIVER=ipapi, quando não há cabeçalho, consulta ipapi.co (envia o IP a terceiros; desligado por padrão). Sem nenhuma das duas, location é null.
GET /access/auth/sessions
Lista as sessões ativas da pessoa logada (em todas as contas), a atual primeiro.
Autenticação: Requerida
Response 200:
json
{
"data": [
{
"id": "9d3f6c1e-2b7a-4c1d-9a51-0f4e2b8c7d10",
"device_type": "desktop",
"browser": "Chrome",
"platform": "Mac",
"ip_address": "200.100.50.10",
"location": { "city": "São Paulo", "region": "São Paulo", "country": "BR" },
"last_active_at": "2026-10-15T14:32:10-03:00",
"created_at": "2026-10-15T09:01:44-03:00",
"is_current": true
}
]
}device_type:desktop,smartphone,tablet,bot… (nullse não identificado).browser/platform: nome do navegador e do sistema operacional, lidos doUser-Agent.
DELETE /access/auth/sessions/{id}
Encerra uma sessão da pessoa logada. O token dela passa a receber 401.
Autenticação: Requerida · Limite: 10 por minuto
Body: { "password": "senha-atual" }
Response 200: { "message": "Sessão encerrada." }
Erros:
| Código | Descrição |
|---|---|
| 404 | Sessão não encontrada, já encerrada ou de outra pessoa |
| 422 | Senha ausente ou incorreta (errors.password) |
POST /access/auth/sessions/logout-others
Encerra todas as outras sessões ativas da pessoa, mantendo a atual.
Autenticação: Requerida · Limite: 10 por minuto
Body: { "password": "senha-atual" }
Response 200:
json
{ "message": "Outras sessões encerradas.", "data": { "revoked": 2 } }Erros:
| Código | Descrição |
|---|---|
| 422 | Senha ausente ou incorreta (errors.password) |
POST /access/account/get-token
Autenticação alternativa via chave+documento (integração API-to-API).
Autenticação: Não requerida
Body:
json
{
"key": "senha-do-usuario",
"token": "documento-cpf-ou-cnpj"
}Response 200:
json
{
"token": "eyJ...",
"token_type": "bearer",
"expires_in": 3600
}Regras de negócio:
tokené o documento (CPF/CNPJ) do usuário.keyé a senha do usuário.