Endpoints de Aplicações

Fazer upload da aplicação

post

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

Authorizations
Body
filestring · binaryRequired

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

Responses
200

Resposta do upload

application/json
Responseone of
or
post
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
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
get
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
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
get
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
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
get
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
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
get
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
Path parameters
appIDstringRequired

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

Responses
200

Aplicação iniciada com sucesso

application/json
put
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
Path parameters
appIDstringRequired

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

Responses
200

Aplicação reiniciada com sucesso

application/json
put
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
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
put
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
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
put
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
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
put
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
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
put
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!"
}

Deletar aplicação

delete

Deleta permanentemente uma aplicação

Authorizations
Path parameters
appIDstringRequired

ID da aplicação a ser deletada

Responses
200

Aplicação deletada com sucesso

application/json
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."
}

Last updated