CoelhoVPS - VPS com Proteção DDoS Login
API REST pública

API REST pública da CoelhoVPS para comprar e gerenciar VPS no Brasil

Use a API para comprar VPS no Brasil, listar instâncias, consultar status e enviar ações como iniciar, parar e reiniciar.

Como autenticar

Envia o token em um cabeçalho Authorization: Bearer.

curl -H "Authorization: Bearer YOUR_TOKEN" https://api.coelhovps.com.br/v1/vps
Importante: para criar uma instância via API, é necessário ter um cartão adicionado na conta. A cobrança é feita automaticamente quando a API provisiona a VPS.
Endpoint Método Objetivo
/v1/vps GET Lista as VPS vinculadas ao usuário autenticado.
/v1/vps/{instance_id} GET Retorna os dados e o status de uma VPS específica.
/v1/vps POST Cria uma VPS e inicia o provisionamento com cobrança automática.
/v1/vps/{instance_id}/action POST Envia ação de start, stop ou restart.

Exemplo: comprar VPS

curl -X POST -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" https://api.coelhovps.com.br/v1/vps -d '{"vcpu":4,"sistema_id":"ubuntu-22-04-lts"}'

O backend resolve o product_id automaticamente a partir de vcpu e do sistema informado.

Exemplo: controlar estado da VPS

curl -X POST -H "Authorization: Bearer YOUR_TOKEN" -H "Content-Type: application/json" https://api.coelhovps.com.br/v1/vps/203430758/action -d '{"action":"stop"}'

Você pode chamar start, stop ou restart para operar a instância remotamente.

Regras de cobrança e provisionamento

  • • Para criação de instância via API, a conta precisa ter um cartão adicionado.
  • • A cobrança da VPS criada ocorre automaticamente ao provisionar a instância.
  • • Quando a criação ainda estiver em andamento, o retorno pode trazer ip_v4 como null; aguarde alguns segundos e consulte novamente.
  • • O endpoint de ação é a forma recomendada para iniciar, parar e reiniciar a VPS sem precisar abrir o painel.