Voltar para Suporte

Documentação da API

Guia de referência para integração com a API de Clientes.

Autenticação
Como autenticar suas requisições.

Todas as requisições devem incluir o header X-API-KEY com sua chave de API.

X-API-KEY: pk_64f..._abcdef...

Endpoints

GET
/client/servers
Listar Servidores
Retorna uma lista de todos os seus servidores.
curl -X GET https://api.sirox.pro/client/servers \
  -H "X-API-KEY: sua_chave_aqui"

Exemplo de Resposta:

[
  {
    "_id": "651...",
    "name": "Meu Servidor",
    "port": 25565,
    "status": "running"
  }
]
GET
/client/servers/:id
Detalhes do Servidor
Retorna informações detalhadas de um servidor específico.
curl -X GET https://api.sirox.pro/client/servers/651... \
  -H "X-API-KEY: sua_chave_aqui"
POST
/client/servers/:id/power
Controle de Energia
Envia comandos de energia para o servidor (start, stop, restart).

Body (JSON):

{
  "action": "start" // ou "stop", "restart"
}
curl -X POST https://api.sirox.pro/client/servers/651.../power \
  -H "X-API-KEY: sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"action": "restart"}'
POST
/client/servers
Criar Servidor
Cria um novo servidor (respeitando seus limites).

Body (JSON):

{
  "name": "Meu Servidor",
  "category": "minecraft", // ou "discord"
  "serverType": "paper",
  "serverVersion": "1.20.4",
  "ramMb": 2048
}
curl -X POST https://api.sirox.pro/client/servers \
  -H "X-API-KEY: sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Novo Servidor",
    "category": "minecraft",
    "serverType": "paper",
    "serverVersion": "1.20.4",
    "ramMb": 2048
  }'