Automatize seus servidores

Cadastrar um servidor

curl -X POST https://ezserver.app/api/v1/servers \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "producao-loja",
    "ip_address": "203.0.113.10",
    "ssh_port": 22,
    "ssh_user": "root",
    "ssh_password": "SENHA_DO_SERVIDOR",
    "type": "vps"
  }'

Obrigatórios: name, ip_address (somente IP), ssh_user e ssh_password (mín. 6 caracteres). Opcionais: ssh_port (padrão 22) e type (vps, dedicated, cloud, shared). O servidor nasce como inactive; chame test-connection para validar e ativar. Para usar chave SSH, cadastre pelo painel. O limite de servidores do plano também vale para a API.

Executar um comando

curl -X POST https://ezserver.app/api/v1/servers/42/execute-command \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"command":"df -h /"}'

# Resposta
{
  "success": true,
  "data": {
    "command": "df -h /",
    "output": "Filesystem  Size  Used Avail Use% Mounted on\n/dev/sda1  80G  27G  53G  34% /\n",
    "error": "",
    "exit_code": 0
  }
}

Terminal SSH em tempo real (WebSocket)

Para embutir o terminal no seu app: peça um ticket com o token da API e abra o WebSocket. A senha e a chave SSH nunca saem do EzServer.

curl -X POST https://ezserver.app/api/v1/servers/42/terminal \
  -H "Authorization: Bearer SEU_TOKEN" -H "Accept: application/json"

# { "data": { "ws_url": "wss://…/ssh-ws", "ticket": "…", "expires_in": 60 } }

// No app (JavaScript)
const ws = new WebSocket(data.ws_url);
ws.onopen = () => ws.send(JSON.stringify({ type: "auth", ticket: data.ticket, cols: 80, rows: 24 }));
ws.onmessage = (ev) => {
  const msg = JSON.parse(ev.data);              // connected | output | error | disconnected
  if (msg.type === "output")                     // saída: UTF-8 em base64
    term.write(new TextDecoder().decode(Uint8Array.from(atob(msg.data), (c) => c.charCodeAt(0))));
};
ws.send(JSON.stringify({ type: "input", data: "ls -la\r" }));
ws.send(JSON.stringify({ type: "resize", cols: 120, rows: 40 }));

O ticket vale 60 segundos e uma única conexão. Por padrão o terminal usa uma sessão persistente tmux: se a conexão cair, peça outro ticket e reconecte para continuar de onde parou. Protocolo completo, teclas especiais, reconexão e exemplos com xterm.js e Python na documentação completa.

Exemplo em Python

import os, requests

BASE = "https://ezserver.app/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['EZSERVER_TOKEN']}", "Accept": "application/json"}

for s in requests.get(f"{BASE}/metrics", headers=HEADERS, timeout=30).json()["data"]:
    if (s.get("disk_usage") or 0) > 85:
        print(f"⚠️  {s['name']}: disco em {s['disk_usage']}%")