Módulo Usuários

Gerencie os usuários com acesso ao painel administrativo da Frota162. Cada usuário pertence a um grupo de permissões e pode ser associado a uma ou mais empresas.

Grupos de usuários

Antes de criar um usuário, consulte os grupos disponíveis para obter o group_user_id correto.

GET /key/user-groups

curl -X GET \
  https://apidev.v1.frota162.com.br/key/user-groups \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Resposta

{
  "groups": [
    {
      "id": 1,
      "name": "Administrador",
      "level": 1
    },
    {
      "id": 2,
      "name": "Operador",
      "level": 2
    }
  ],
  "error": false
}

Criar usuário

POST /key/create-user

curl -X POST \
  https://apidev.v1.frota162.com.br/key/create-user \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "João Silva",
    "username": "joao.silva",
    "email": "joao@empresa.com",
    "password": "senha123",
    "password_confirm": "senha123",
    "group_user_id": 2,
    "companies_ids": [1, 3]
  }'

Campos

Campo	Tipo	Obrigatório	Descrição
name	string	Sim	Nome completo do usuário
username	string	Sim	Nome de usuário para login
email	string	Sim	E-mail de acesso
password	string	Sim	Senha
password_confirm	string	Sim	Confirmação da senha (deve ser igual a password)
group_user_id	integer	Sim	ID do grupo de permissões (use /key/user-groups)
companies_ids	array	Sim	Lista de IDs das empresas às quais o usuário terá acesso

Resposta

{
  "message": "Usuário cadastrado com sucesso",
  "error": false,
  "user": {
    "id": 10,
    "name": "João Silva",
    "username": "joao.silva",
    "email": "joao@empresa.com",
    "group_user_id": 2,
    "account_id": 5,
    "secretKey": "...",
    "accessToken": "..."
  }
}

observação

A resposta inclui secretKey e accessToken do novo usuário. Guarde esses valores com segurança — eles são usados para autenticar requisições HMAC desse usuário.

Desativar usuário

DELETE /key/disable-user/{id_user}

curl -X DELETE \
  https://apidev.v1.frota162.com.br/key/disable-user/10 \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

Resposta

{
  "message": "Usuário desabilitado com sucesso",
  "error": false
}

Reativar usuário

GET /key/enable-user/{id_user}

curl -X GET \
  https://apidev.v1.frota162.com.br/key/enable-user/10 \
  -H 'Authorization: Basic SEU_ACCESS_TOKEN' \
  -H 'Key: SUA_ASSINATURA_HMAC'

---