Aplicações

Fazer upload da aplicação

post

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

Authorizations

ApiKeyAuth

api-tokenstringRequired

Body

multipart/form-data

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

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}

HTTPcURLJavaScriptPython

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

ApiKeyAuth

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstringRequired

ID da aplicação para atualizar a RAM

Body

application/json

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstringRequired

ID da aplicação a ser atualizada

Body

multipart/form-data

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstringRequired

ID da aplicação a ser atualizada

Body

application/json

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstringRequired

ID da aplicação

Body

application/json

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstringRequired

ID da aplicação

Body

application/json

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstringRequired

ID da aplicação

Body

application/json

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

HTTPcURLJavaScriptPython

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

ApiKeyAuth

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

HTTPcURLJavaScriptPython

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