Ctrlk
Sair da Documentação
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Aplicações

Fazer upload da aplicação

post

Faz upload de uma nova aplicação para a Discloud

Authorizations
api-tokenstringRequired
Body
filestring · binaryRequired

Arquivo da aplicação para fazer upload (formato .ZIP)

projectIdstringOptional

ID do projeto ao qual a aplicação será vinculada no upload (opcional).

Responses
200

Resposta do upload

application/json
or
post/upload
POST /v2/upload HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 36

{
  "file": "binary",
  "projectId": "text"
}
{
  "status": "ok",
  "statusCode": 200,
  "message": "Sua aplicação foi hospedada com sucesso.",
  "app": {
    "id": "1745338954955",
    "type": 0,
    "name": "Bot javascript",
    "avatarURL": "https://i.imgur.com/bWhx7OT.png",
    "ram": 100,
    "apts": "",
    "clusterName": "fenrir",
    "exitCode": 0,
    "online": true,
    "ramKilled": false,
    "syncGit": null,
    "mainFile": "index.js",
    "lang": "javascript",
    "version": "latest",
    "addedAtTimestamp": 1719010867306,
    "autoRestart": false
  }
}

Obter informações da aplicação

get

Recupera informações sobre uma aplicação específica ou todas as aplicações

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação ou "all" para recuperar todas as aplicações

Responses
200

Informações da aplicação recuperadas com sucesso

application/json
statusstringOptional
messagestringOptional
appsone ofOptional
or
get/app/{appID}
GET /v2/app/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "As informações da sua aplicação foram carregadas.",
  "apps": {
    "id": "1745338954955",
    "avatarURL": "https://i.ibb.co/xSxd0Hv1/Uma105.png",
    "name": "Temp2 - JS",
    "type": 0,
    "online": true,
    "ramKilled": false,
    "exitCode": 0,
    "ram": 100,
    "mainFile": "src/index.js",
    "lang": "javascript",
    "autoDeployGit": "no",
    "autoRestart": false
  }
}

Obter status da aplicação

get

Recupera informações de status sobre uma aplicação específica ou todas as aplicações

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação ou "all" para recuperar status de todas as aplicações

Responses
200

Status da aplicação obtido com sucesso

application/json
statusstringOptional
messagestringOptional
appsone ofOptional
or
get/app/{appID}/status
GET /v2/app/{appID}/status HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Os status de sua aplicação foram carregados.",
  "apps": {
    "id": "1745338954955",
    "container": "Online",
    "cpu": "0.00%",
    "memory": "39.9MB/100MB",
    "ssd": "1.999GB",
    "netIO": {
      "down": "61KB",
      "up": "16KB"
    },
    "last_restart": "30 minutos",
    "startedAt": "2025-04-22T16:24:55.978921501Z"
  }
}

Obter logs da aplicação

get

Recupera os logs de uma aplicação específica ou de todas as aplicações

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação ou "all" para recuperar logs de todas as aplicações

Responses
200

Logs da aplicação recuperados com sucesso

application/json
statusstringOptional
messagestringOptional
appsone ofOptional
or
get/app/{appID}/logs
GET /v2/app/{appID}/logs HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Os logs de suas aplicações foram carregados.",
  "apps": {
    "id": "1745338954955",
    "terminal": {
      "big": "2025-04-22T14:30:00.123Z Aplicação iniciando...\n2025-04-22T14:30:01.234Z Ambiente: produção\n2025-04-22T14:30:01.567Z Carregando arquivos de configuração...\n2025-04-22T14:30:02.123Z Conexão com banco de dados estabelecida\n2025-04-22T14:30:02.456Z Inicializando módulos do servidor\n2025-04-22T14:30:03.678Z Servidor ouvindo na porta 3000\n2025-04-22T14:30:04.123Z Serviço WebSocket inicializado\n2025-04-22T14:30:04.567Z Cache aquecendo\n2025-04-22T14:30:05.234Z Inicialização da aplicação completa\n2025-04-22T14:30:06.123Z Processando solicitações iniciais",
      "small": "2025-04-22T14:30:00.123Z Aplicação iniciando...\n2025-04-22T14:30:02.123Z Conexão com banco de dados estabelecida\n2025-04-22T14:30:03.678Z Servidor ouvindo na porta 3000\n2025-04-22T14:30:05.234Z Inicialização da aplicação completa",
      "url": "discloud.app"
    }
  }
}

Obter backup da aplicação

get

Gera e recupera o backup de uma aplicação específica ou de todas as aplicações

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação ou "all" para recuperar backups de todas as aplicações

Responses
200

Backup da aplicação gerado com sucesso

application/json
statusstringOptional
messagestringOptional
backupsone ofOptional
or
get/app/{appID}/backup
GET /v2/app/{appID}/backup HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "O backup da sua aplicação será gerado com sucesso",
  "backups": {
    "id": "1745338954955",
    "url": "https://discloud.app/backup/A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1V2W3X4Y5Z6.zip"
  }
}

Iniciar aplicação

put

Inicia uma aplicação específica ou todas as aplicações

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação ou "all" para iniciar todas as aplicações

Responses
200

Aplicação iniciada com sucesso

application/json
statusstringOptional
messagestringOptional
put/app/{appID}/start
PUT /v2/app/{appID}/start HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Sua aplicação foi conectada.",
  "appStatus": {
    "online": true,
    "ramKilled": false,
    "exitCode": 0
  }
}

Reiniciar aplicação

put

Reinicia uma aplicação específica ou todas as aplicações

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação ou "all" para reiniciar todas as aplicações

Responses
200

Aplicação reiniciada com sucesso

application/json
statusstringOptional
messagestringOptional
put/app/{appID}/restart
PUT /v2/app/{appID}/restart HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Sua aplicação foi reiniciada."
}

Parar aplicação

put

Para uma aplicação específica ou todas as aplicações

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação ou "all" para parar todas as aplicações

Responses
200

Resposta de parada da aplicação

application/json
statusstringOptional
messagestringOptional
put/app/{appID}/stop
PUT /v2/app/{appID}/stop HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Sua aplicação foi parada."
}

Atualizar RAM da aplicação

put

Atualiza a alocação de RAM para uma aplicação específica

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação para atualizar a RAM

Body
ramMBintegerRequired

A quantidade de RAM em MB para alocar a aplicação

Example: 200
Responses
200

Resposta de atualização de RAM

application/json
statusstringOptional
statusCodeintegerOptional
messagestringOptional
put/app/{appID}/ram
PUT /v2/app/{appID}/ram HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "ramMB": 200
}
{
  "status": "ok",
  "statusCode": 200,
  "message": "A memória do seu aplicativo foi alterada com sucesso."
}

Atualizar código da aplicação

put

Atualiza uma aplicação existente fazendo upload de uma nova versão do código

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação a ser atualizada

Body
filestring · binaryRequired

Arquivo da aplicação a ser enviado (formato .ZIP)

Responses
200

Resposta de commit

application/json
statusstringOptional
messagestringOptional
put/app/{appID}/commit
PUT /v2/app/{appID}/commit HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}
{
  "summary": "Commit bem-sucedido (pode expirar)",
  "description": "Quando bem-sucedido, a solicitação pode expirar sem retornar uma resposta"
}

Atualizar perfil da aplicação

put

Atualiza as informações de perfil (avatar e nome) de uma aplicação específica

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação a ser atualizada

Body
avatarURLstringRequired

URL para a imagem do avatar da aplicação

Example: https://i.ibb.co/0yJhZw92/Uma01.png
namestringRequired

Nome da aplicação

Example: Discloud App
Responses
200

Perfil da aplicação atualizado com sucesso

application/json
statusstringOptional
statusCodeintegerOptional
messagestringOptional
put/app/{appID}/profile
PUT /v2/app/{appID}/profile HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "avatarURL": "https://i.ibb.co/0yJhZw92/Uma01.png",
  "name": "Discloud App"
}
{
  "status": "ok",
  "statusCode": 200,
  "message": "Perfil modificado com sucesso!"
}

Listar arquivos e pastas

get

Lista arquivos e pastas no diretório da aplicação

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação

Query parameters
cPathstringOptional

Caminho do diretório (padrão: workDir da app)

Responses
200

Arquivos e pastas listados com sucesso

application/json
statusstringOptionalExample: ok
pathstringOptional

Caminho do diretório atual

get/app/{appID}/explorer
GET /v2/app/{appID}/explorer HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "path": "/root/app",
  "dir": [
    {
      "name": "index.js",
      "type": "file",
      "size": 1024
    },
    {
      "name": "src",
      "type": "directory"
    }
  ]
}

Criar arquivo ou pasta

post

Cria um novo arquivo ou pasta na aplicação

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação

Body
typeFilestring · enumRequired

Tipo a criar

Possible values:
cPathstringRequired

Caminho completo para o novo arquivo ou diretório

Responses
200

Arquivo ou pasta criado com sucesso

application/json
statusstringOptionalExample: ok
pathstringOptional

Caminho do alvo da operação

post/app/{appID}/explorer
POST /v2/app/{appID}/explorer HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "typeFile": "file",
  "cPath": "text"
}
{
  "status": "ok",
  "path": "/root/app/newfile.js"
}

Abrir/ler arquivo

get

Lê o conteúdo de um arquivo na aplicação

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação

Query parameters
cPathstringRequired

Caminho completo do arquivo

Responses
200

Arquivo aberto com sucesso

application/json
statusstringOptionalExample: ok
pathstringOptional

Caminho completo do arquivo

namestringOptional

Nome do arquivo

contentstringOptional

Conteúdo do arquivo

messagestringOptional
get/app/{appID}/explorer/open
GET /v2/app/{appID}/explorer/open?cPath=text HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "path": "/root/app/index.js",
  "name": "index.js",
  "content": "console.log('Hello World');",
  "message": ""
}

Editar arquivo

put

Edita o conteúdo de um arquivo na aplicação

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação

Body
fileContentstringRequired

Novo conteúdo do arquivo

cPathstringRequired

Caminho completo do arquivo

Responses
200

Arquivo editado com sucesso

application/json
statusstringOptionalExample: ok
pathstringOptional

Caminho do alvo da operação

put/app/{appID}/explorer/edit
PUT /v2/app/{appID}/explorer/edit HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "fileContent": "text",
  "cPath": "text"
}
{
  "status": "ok",
  "path": "/root/app/index.js"
}

Executar comando no container

put

Executa um comando dentro do container da aplicação

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação

Body
cmdstringRequired

Comando a ser executado no container

Responses
200

Comando executado com sucesso

application/json
statusstringOptional
statusCodeintegerOptional
messagestringOptional
execone ofOptional
or
object · nullableOptional
put/app/{appID}/exec
PUT /v2/app/{appID}/exec HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "cmd": "ls -la"
}
{
  "status": "ok",
  "statusCode": 200,
  "message": "ok",
  "exec": {
    "stdout": "total 48\ndrwxr-xr-x 5 user user 4096 Dec 17 10:30 .\n...",
    "stderr": "",
    "exitCode": 0
  }
}

Deletar aplicação

delete

Deleta permanentemente uma aplicação

Authorizations
api-tokenstringRequired
Path parameters
appIDstringRequired

ID da aplicação a ser deletada

Responses
200

Aplicação deletada com sucesso

application/json
statusstringOptional
messagestringOptional
delete/app/{appID}/delete
DELETE /v2/app/{appID}/delete HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*

{
  "status": "ok",
  "message": "Sua aplicação foi removida."
}
AnteriorUsuário
SeguinteVariáveis de ambiente

Última atualização