Autenticação de API (Server-to-Server)

Este documento descreve como obter um token de acesso temporário para realizar requisições na API do FastGivr.

---

🔑 Obter Token de Acesso (account/get-token)

Utilizado para integradores e sistemas externos que precisam de acesso programático.

• Endpoint: POST /access/account/get-token
• Headers:
  • Content-Type: application/json
  • Accept: application/json

Parâmetros da Requisição (Body)

Campo	Tipo	Obrigatório	Descrição
email	string	Sim	E-mail do usuário vinculado à conta.
token	string	Sim	Token fixo da conta (disponível no painel administrativo).

Exemplo de Requisição

curl -X POST https://api.fastgivr.com.br/access/account/get-token \
     -H "Content-Type: application/json" \
     -d '{
           "email": "integrador@empresa.com",
           "token": "STAT_TOKEN_123..."
         }'

Exemplo de Resposta (200 OK)

Retorna um token Bearer de curta duração (padrão 10 minutos) e a lista de permissões vinculadas.

{
  "success": true,
  "data": {
    "token": "2|apiKeyToken...",
    "token_type": "Bearer",
    "expires_at": "2026-05-15T14:10:00+00:00",
    "permissions": [
      { "id": 1, "name": "charges.index", "guard_name": "web" },
      { "id": 2, "name": "charges.create", "guard_name": "web" }
    ]
  },
  "message": "Autenticado com sucesso"
}

---

🔒 Utilizando o Token

Após obter o token, utilize-o no header de todas as requisições subsequentes:

Authorization: Bearer 2|apiKeyToken...

IMPORTANT

O token gerado expira em 10 minutos. Recomenda-se implementar uma lógica de renovação automática em seu integrador.