Projetos
Consulte o contrato e um exemplo de cada operação, sem percorrer uma lista inteira.
Neste artigo
Operações e exemplos
Abra a página do recurso desejado no menu lateral ou nos links abaixo. O exemplo pode ser copiado nas linguagens disponíveis. Os exemplos são referências e não executam chamadas automaticamente.
/api/serversListar projetos
Lista os projetos e suas reservas individuais.
[{"id":"<uuid>","name":"api","runtime":"node","version":"22","status":"online","memory_mb":256,"cpu":0,"disk_unlimited":true,"start_command":"node index.js"}]const response = await fetch('https://runixcloud.online/api/servers', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/serversCriar projeto
Reserva recursos do pool e cria um container parado, pronto para receber o deploy.
{
"name": "api",
"runtime": "node",
"version": "22",
"memory_mb": 256,
"start_command": "node index.js"
}{"id":"<uuid>","status":"offline"}const response = await fetch('https://runixcloud.online/api/servers', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"name": "api",
"runtime": "node",
"version": "22",
"memory_mb": 256,
"start_command": "node index.js"
})
});
console.log(await response.text());/api/servers/:id/deployDeploy de ZIP
Extrai um pacote .zip diretamente em /workspace. Se houver uma única pasta raiz, ela é removida automaticamente.
{"status":"deployed"}import { readFile } from 'node:fs/promises';
const form = new FormData();
form.append('file', new Blob([await readFile('./project.zip')]), 'project.zip');
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/deploy', {
method: 'POST',
headers: { 'Authorization': 'Bearer ' + TOKEN },
body: form
});
console.log(response.status, await response.text());/api/servers/:id/redeployRedeploy de ZIP
Valida o ZIP, substitui todo o /workspace e preserva o estado do serviço. Se estava online, reinicia após a publicação; se estava parado, permanece parado.
{"status":"redeployed","restarted":true}import { readFile } from 'node:fs/promises';
const form = new FormData();
form.append('file', new Blob([await readFile('./project.zip')]), 'project.zip');
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/redeploy', {
method: 'POST',
headers: { 'Authorization': 'Bearer ' + TOKEN },
body: form
});
console.log(response.status, await response.text());/api/servers/:id/dependencies/installInstalar dependências
Instala os pacotes do manifesto sem novo ZIP. Funciona com a aplicação online ou parada; reinicie após concluir para carregar os novos pacotes.
{"status":"installed","output":"...","exit_code":0}const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/dependencies/install', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/servers/:idDetalhar projeto
Retorna runtime, estado, comando e recursos reservados.
{"id":"<uuid>","name":"api","status":"online","memory_mb":256,"cpu":0,"disk_unlimited":true,"start_command":"node index.js"}const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/servers/:idAtualizar projeto
Altera nome e RAM dentro do pool. A CPU é compartilhada automaticamente.
{
"name": "api-prod",
"memory_mb": 512
}const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID', {
method: 'PATCH',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"name": "api-prod",
"memory_mb": 512
})
});
console.log(response.status);/api/servers/:idExcluir projeto
Remove o container e devolve os recursos reservados ao pool.
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(response.status);/api/servers/:id/startStart projeto
Executa start no container. Stop/restart/kill persistem um snapshot de logs antes da ação.
{"status":"online"}const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/start', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/servers/:id/stopStop projeto
Executa stop no container. Stop/restart/kill persistem um snapshot de logs antes da ação.
{"status":"offline"}const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/stop', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/servers/:id/restartRestart projeto
Executa restart no container. Stop/restart/kill persistem um snapshot de logs antes da ação.
{"status":"online"}const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/restart', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/servers/:id/killKill projeto
Executa kill no container. Stop/restart/kill persistem um snapshot de logs antes da ação.
{"status":"killed"}const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/kill', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());/api/servers/:id/reinstallReinstalar workspace
Limpa os arquivos do workspace mantendo recursos, rede e registro do projeto.
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/reinstall', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());