Arquivos
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.
GET
Bearer JWT/api/servers/:id/filesListar arquivos
Lista um nível de /workspace usando a API de archive do Docker; funciona também com container parado.
Query
path=/workspaceSucesso 200
Resposta
{"files":[{"name":"index.js","type":"f","size":"124"}]}Node.js
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/files?path=/workspace', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());GET
Bearer JWT/api/servers/:id/files/contentLer arquivo
Lê até 32 MB de um arquivo do workspace.
Query
path=/workspace/index.jsSucesso 200 text/plainErros 404
Node.js
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/files/content?path=/workspace/index.js', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());POST
Bearer JWT/api/servers/:id/filesSalvar arquivo de texto
Cria ou sobrescreve conteúdo textual.
Body
{
"path": "/workspace/index.js",
"content": "console.log(\"RunixCloud\")\n"
}O editor JSON continua limitado a 2 MiB.
Sucesso 204
Node.js
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/files', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"path": "/workspace/index.js",
"content": "console.log(\"RunixCloud\")\n"
})
});
console.log(response.status);POST
Bearer JWT/api/servers/:id/files/uploadUpload de arquivo
Envia um arquivo binário para o diretório informado.
Query
path=/workspaceSucesso 201Erros 413 acima de 32 MB
Resposta
{"name":"logo.png","path":"/workspace/logo.png","size":12345}Node.js
import { readFile } from 'node:fs/promises';
const form = new FormData();
form.append('file', new Blob([await readFile('./arquivo.bin')]), 'arquivo.bin');
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/files/upload?path=/workspace', {
method: 'POST',
headers: { 'Authorization': 'Bearer ' + TOKEN },
body: form
});
console.log(response.status, await response.text());GET
Bearer JWT/api/servers/:id/files/downloadDownload de arquivo
Baixa um arquivo como application/octet-stream.
Query
path=/workspace/logo.pngSucesso 200
Node.js
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/files/download?path=/workspace/logo.png', {
method: 'GET',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(await response.text());POST
Bearer JWT/api/servers/:id/foldersCriar diretório
Cria diretório no workspace.
Body
{
"path": "/workspace/src"
}Sucesso 201
Node.js
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/folders', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
"path": "/workspace/src"
})
});
console.log(await response.text());DELETE
Bearer JWT/api/servers/:id/filesExcluir arquivo/diretório
Remove recursivamente dentro do workspace. A operação requer o container em execução porque utiliza exec.
Query
path=/workspace/oldSucesso 204
Node.js
const response = await fetch('https://runixcloud.online/api/servers/SERVER_ID/files?path=/workspace/old', {
method: 'DELETE',
headers: {
'Authorization': 'Bearer ' + TOKEN
},
});
console.log(response.status);