POST
https://api.myidvirtual.com
/
server
Criar Servidor
curl --request POST \
  --url https://api.myidvirtual.com/server \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "ip": "<string>",
  "port": 123,
  "country": "<string>",
  "city": "<string>",
  "username": "<string>",
  "password": "<string>",
  "notes": "<string>"
}
'
{
  "server": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "BR-SP-001",
    "ip": "192.168.1.100",
    "port": 1194,
    "country": "Brazil",
    "city": "São Paulo",
    "username": "root",
    "password": "password",
    "notes": "Servidor principal em São Paulo",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-15T10:30:00.000Z"
  },
  "message": "Server cadastrado com sucesso"
}

​
Criar Servidor

Endpoint para criação de novos servidores VPN. Permite cadastrar servidores com diferentes configurações e localizações geográficas.

​
Endpoint

​
Autenticação

​
Authorization
string
required
Bearer token JWT com privilégios administrativos

​
Parâmetros

​
Request Body

​
name
string
required
Nome do servidor VPN
​
ip
string
required
Endereço IP do servidor
​
port
number
required
Porta de conexão do servidor
​
country
string
required
País onde o servidor está localizado
​
city
string
Cidade onde o servidor está localizado
​
username
string
required
Username pra autenticar na conexao ao servidor
​
password
string
required
Senha pra autenticar na conexao ao servidor
​
notes
string
Notas visivel apenas pra admin.

​
Responses

{
  "server": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "BR-SP-001",
    "ip": "192.168.1.100",
    "port": 1194,
    "country": "Brazil",
    "city": "São Paulo",
    "username": "root",
    "password": "password",
    "notes": "Servidor principal em São Paulo",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-15T10:30:00.000Z"
  },
  "message": "Server cadastrado com sucesso"
}

​
Exemplo de Requisição

curl --location --request POST 'http://localhost:3333/server' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "BR-SP-001",
    "ip": "192.168.1.100",
    "port": 1194,
    "country": "Brazil",
    "city": "São Paulo",
    "username": "root",
    "password": "password",
    "notes": "Servidor principal em São Paulo",
}'

​
Protocolos Suportados

​
WireGuard

  • Protocolo moderno e rápido
  • Melhor performance
  • Porta típica: 51820

​
Validações

​
Endereço IP

  • Formato IPv4 ou IPv6 válido
  • Deve ser único no sistema
  • Campo obrigatório

​
Porta

  • Número entre 1 e 65535
  • Recomendado: usar portas não privilegiadas (> 1024)
  • Campo obrigatório

​
Event Logging

Este endpoint automaticamente registra eventos de criação de servidor:
  • Timestamp da criação
  • ID do administrador
  • Dados completos do servidor
  • IP de origem da requisição
Apenas administradores podem criar servidores. Certifique-se de que o servidor está configurado corretamente antes de ativá-lo.

​
Próximos Passos

Após criar um servidor:
  1. Configure certificados SSL/TLS para conexões seguras
  2. Execute o setup inicial usando /server/setup/:id
  3. Teste a conectividade antes de disponibilizar para usuários
  4. Configure monitoramento de recursos e disponibilidade
Servidores criados ficam inativos por padrão até que sejam configurados e testados adequadamente.