Aplicações | Discloud Docs

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)

Responses

200

Resposta do upload

application/json

Responseone of

or

401

Erro de autenticação

application/json

404

Arquivo obrigatório ausente

application/json

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: 17

{
  "file": "binary"
}

No content

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

401

Erro de autenticação

application/json

404

Aplicação não encontrada

application/json

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",
    "mods": [],
    "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

401

Erro de autenticação

application/json

404

Aplicação não encontrada

application/json

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

401

Erro de autenticação

application/json

404

Aplicação não encontrada

application/json

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

401

Erro de autenticação

application/json

404

Aplicação não encontrada

application/json

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

401

Erro de autenticação

application/json

404

Aplicação não encontrada

application/json

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

401

Erro de autenticação

application/json

404

Aplicação não encontrada

application/json

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

401

Erro de autenticação

application/json

404

Aplicação não encontrada

application/json

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

401

Erro de autenticação

application/json

404

Aplicação não encontrada ou limitação do plano

application/json

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

401

Erro de autenticação

application/json

404

Aplicação não encontrada

application/json

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

401

Erro de autenticação

application/json

404

Aplicação não encontrada

application/json

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

401

Erro de autenticação

application/json

403

Sem permissão ou plano insuficiente

application/json

404

Aplicação não encontrada ou caminho inválido

application/json

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

400

Requisição inválida - campos obrigatórios faltando

application/json

401

Erro de autenticação

application/json

403

Sem permissão ou plano insuficiente

application/json

404

Aplicação não encontrada ou caminho inválido

application/json

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

401

Erro de autenticação

application/json

403

Sem permissão ou plano insuficiente

application/json

404

Arquivo não encontrado ou caminho inválido

application/json

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

400

Requisição inválida - campos obrigatórios faltando

application/json

401

Erro de autenticação

application/json

403

Sem permissão ou plano insuficiente

application/json

404

Arquivo não encontrado ou caminho inválido

application/json

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

401

Erro de autenticação

application/json

403

Sem permissão - apenas dono da app pode executar comandos

application/json

404

Aplicação não encontrada ou offline

application/json

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

401

Erro de autenticação

application/json

404

Aplicação não encontrada

application/json

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."
}

hashtagFazer upload da aplicação

hashtagObter informações da aplicação

hashtagObter status da aplicação

hashtagObter logs da aplicação

hashtagObter backup da aplicação

hashtagIniciar aplicação

hashtagReiniciar aplicação

hashtagParar aplicação

hashtagAtualizar RAM da aplicação

hashtagAtualizar código da aplicação

hashtagAtualizar perfil da aplicação

hashtagListar arquivos e pastas

hashtagCriar arquivo ou pasta

hashtagAbrir/ler arquivo

hashtagEditar arquivo

hashtagExecutar comando no container

hashtagDeletar aplicação

Fazer upload da aplicação

Obter informações da aplicação

Obter status da aplicação

Obter logs da aplicação

Obter backup da aplicação

Iniciar aplicação

Reiniciar aplicação

Parar aplicação

Atualizar RAM da aplicação

Atualizar código da aplicação

Atualizar perfil da aplicação

Listar arquivos e pastas

Criar arquivo ou pasta

Abrir/ler arquivo

Editar arquivo

Executar comando no container

Deletar aplicação