GET
https://api.myidvirtual.com
/
server
Listar Servidores
curl --request GET \
  --url https://api.myidvirtual.com/server \
  --header 'Authorization: <authorization>'
[
  [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "BR-SP-001",
      "ip": "192.168.1.100",
      "port": 1194,
      "country": "Brazil",
      "city": "São Paulo",
      "protocol": "OpenVPN",
      "status": true,
      "capacity": 500,
      "currentLoad": 245,
      "description": "Servidor principal em São Paulo",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "id": "223e4567-e89b-12d3-a456-426614174001",
      "name": "US-NY-001",
      "ip": "192.168.2.100",
      "port": 1194,
      "country": "United States",
      "city": "New York",
      "protocol": "OpenVPN",
      "status": true,
      "capacity": 1000,
      "currentLoad": 523,
      "description": "Servidor em Nova York",
      "createdAt": "2024-01-16T14:20:00.000Z",
      "updatedAt": "2024-01-16T14:20:00.000Z"
    }
  ],
  2
]

​
Listar Servidores

Endpoint para obter a lista completa de servidores VPN disponíveis no sistema.

​
Autenticação

​
Authorization
string
required
Bearer token JWT do usuário autenticado

​
Autorização

​
Responses

[
  [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "BR-SP-001",
      "ip": "192.168.1.100",
      "port": 1194,
      "country": "Brazil",
      "city": "São Paulo",
      "protocol": "OpenVPN",
      "status": true,
      "capacity": 500,
      "currentLoad": 245,
      "description": "Servidor principal em São Paulo",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "id": "223e4567-e89b-12d3-a456-426614174001",
      "name": "US-NY-001",
      "ip": "192.168.2.100",
      "port": 1194,
      "country": "United States",
      "city": "New York",
      "protocol": "OpenVPN",
      "status": true,
      "capacity": 1000,
      "currentLoad": 523,
      "description": "Servidor em Nova York",
      "createdAt": "2024-01-16T14:20:00.000Z",
      "updatedAt": "2024-01-16T14:20:00.000Z"
    }
  ],
  2
]

​
Exemplo de Requisição

curl --location --request GET 'http://localhost:3333/server' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

​
Estrutura da Resposta

A resposta retorna um array com dois elementos:
  1. Array de servidores: Lista com todos os objetos de servidor
  2. Total: Número total de servidores

​
Campos do Servidor

​
id
string
ID único do servidor
​
name
string
Nome identificador do servidor
​
ip
string
Endereço IP do servidor
​
port
number
Porta de conexão
​
country
string
País onde o servidor está localizado
​
city
string
Cidade onde o servidor está localizado
​
protocol
string
Protocolo VPN utilizado
​
status
boolean
Status do servidor (true = ativo, false = inativo)
​
capacity
number
Capacidade máxima de usuários
​
currentLoad
number
Número atual de usuários conectados
​
description
string
Descrição do servidor
A lista inclui tanto servidores ativos quanto inativos. Filtre pelo campo status para mostrar apenas servidores disponíveis.

​
Event Logging

Este endpoint registra automaticamente:
  • ID do usuário
  • Quantidade de servidores retornados