API — Dynamic Login

O Dynamic Login permite que um sistema externo autentique um usuário no Wi-Fi sem que ele precise interagir com o portal captive. Útil para integração com sistemas próprios de recepção, terminais de autoatendimento ou apps mobile.

Como funciona

1. Sistema externo autentica o usuário

   Seu sistema (recepção, app, ERP) valida a identidade do usuário pela sua própria lógica.

2. Sistema chama a API Dynamic Login

   Seu sistema faz um POST para /api/v1/auth/dynamic-login com o MAC address do dispositivo do usuário.

3. CaptiveWeb libera o acesso

   O CaptiveWeb envia um RADIUS CoA ao equipamento de rede, liberando o acesso do dispositivo com aquele MAC.

Endpoint

POST /api/v1/auth/dynamic-login
Authorization: Bearer SEU_TOKEN
Content-Type: application/json

{
  "mac_address": "AA:BB:CC:DD:EE:FF",
  "location_id": "loc_xxx",
  "duration_hours": 8,
  "user": {
    "name": "João Silva",
    "email": "joao@email.com"
  }
}

Resposta de sucesso:

{
  "session_id": "sess_xyz789",
  "status": "authorized",
  "expires_at": "2026-05-05T22:00:00Z"
}

Requisitos

• O equipamento de rede deve suportar RADIUS CoA (porta 3799 UDP aberta para o servidor)
• O MAC address deve estar no formato AA:BB:CC:DD:EE:FF
• O dispositivo deve estar conectado à rede do local especificado no location_id