Documentação Pixel Host

Rede e RCON

Consulte a conexão pública e configure o RCON sem expor a senha em respostas.

As portas internas não fazem parte do contrato público. Use sempre o domínio exibido no painel.

Alterações de RCON exigem reinício do servidor. A senha pode ser definida ou substituída, mas nunca é retornada pela API.

Endpoints

GET/servers/{serverId}/network

Retorna hostname, protocolo público e estado do DNS.

Permissão: network.read

Como enviar

curl -sS -X GET \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/servers/SEU_SERVER_ID/network"

Resposta HTTP 200

{
  "address": "servidor-pixel.pixel-host.com.br",
  "port": 25565,
  "protocol": "ipv6-only",
  "ipv4Available": false,
  "dns": { "hostname": "servidor-pixel.pixel-host.com.br", "ready": true, "warnings": [] }
}

GET/servers/{serverId}/rcon

Lê porta, estado e necessidade de reinício.

Permissão: server.rcon.read

Como enviar

curl -sS -X GET \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  "https://pixel-host.com.br/api/v1/servers/SEU_SERVER_ID/rcon"

Resposta HTTP 200

{
  "rcon": {
    "enabled": true,
    "port": 27000,
    "passwordConfigured": true,
    "broadcastToOps": true
  }
}

PUT/servers/{serverId}/rcon

Ativa ou altera o RCON.

Permissão: server.rcon.update

Como enviar

curl -sS -X PUT \
  -H "Authorization: Bearer $PIXEL_HOST_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{ "enabled": true, "port": 27000, "password": "senha-com-12-caracteres", "broadcastToOps": true }' \
  "https://pixel-host.com.br/api/v1/servers/SEU_SERVER_ID/rcon"

Corpo JSON formatado

{ "enabled": true, "port": 27000, "password": "senha-com-12-caracteres", "broadcastToOps": true }

Resposta HTTP 200

{
  "rcon": { "enabled": true, "port": 27000, "passwordConfigured": true },
  "restartRequired": true
}

API basehttps://pixel-host.com.br/api/v1