openapi-pt.json

{
  "openapi": "3.0.3",
  "info": {
    "title": "Discloud API",
    "description": "Bem Vindo à API da DisCloud!\nSinta-se à vontade para consultar e experimentar todas as rotas da nossa API nesta página!",
    "termsOfService": "https://discloudbot.com/legal/terms",
    "version": "v2"
  },
  "servers": [
    {
      "url": "https://api.discloud.app/v2"
    }
  ],
  "tags": [
    {
      "name": "User",
      "description": "Informações sobre o Utilizador"
    },
    {
      "name": "Upload",
      "description": "Upload de Aplicações"
    },
    {
      "name": "App",
      "description": "Rotas de Gerenciamento de APPs"
    },
    {
      "name": "Team Manager",
      "description": "Rotas de Gerenciamento da Team"
    },
    {
      "name": "Team",
      "description": "Rotas de Gerenciamento das Aplicações da Team"
    }
  ],
  "paths": {
    "/user": {
      "get": {
        "tags": [
          "User"
        ],
        "summary": "User Info",
        "description": "Informações sobre o usuário do token fornecido",
        "operationId": "getUser",
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/upload": {
      "post": {
        "tags": [
          "Upload"
        ],
        "summary": "App Upload",
        "description": "Fazer o upload de uma aplicação",
        "operationId": "uploadApp",
        "requestBody": {
          "$ref": "#/components/requestBodies/sendFile"
        },
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "App Info",
        "description": "Obter informações da aplicação",
        "operationId": "getInfoApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/status": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "App Status",
        "description": "Obter informações de status da aplicação",
        "operationId": "getStatusApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/logs": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "App Logs",
        "description": "Obter os logs da aplicação",
        "operationId": "getLogsApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/backup": {
      "get": {
        "tags": [
          "App"
        ],
        "summary": "App Backup",
        "description": "Obter o backup da aplicação",
        "operationId": "getBackupApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/locale/{locale}": {
      "put": {
        "tags": [
          "User"
        ],
        "summary": "Set locale",
        "description": "Mudar a linguagem do usuário do token fornecido",
        "operationId": "setLocale",
        "parameters": [
          {
            "name": "locale",
            "in": "path",
            "description": "Linguagem pretendida",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "pt-BR",
                "en-US"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/start": {
      "put": {
        "tags": [
          "App"
        ],
        "summary": "App Start",
        "description": "Iniciar Aplicação",
        "operationId": "startApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/restart": {
      "put": {
        "tags": [
          "App"
        ],
        "summary": "App Restart",
        "description": "Reiniciar aplicação",
        "operationId": "restartApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/stop": {
      "put": {
        "tags": [
          "App"
        ],
        "summary": "App Stop",
        "description": "Parar aplicação",
        "operationId": "stopApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/ram": {
      "put": {
        "tags": [
          "App"
        ],
        "summary": "App RAM",
        "description": "Mudar a RAM da aplicação",
        "operationId": "setRamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/setRam"
        },
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/commit": {
      "put": {
        "tags": [
          "App"
        ],
        "summary": "App Commit",
        "description": "Fazer um Commit para uma aplicação",
        "operationId": "commitApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/sendFile"
        },
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/delete": {
      "delete": {
        "tags": [
          "App"
        ],
        "summary": "App Delete",
        "description": "Excluir aplicação",
        "operationId": "deleteApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/team": {
      "get": {
        "tags": [
          "Team Manager"
        ],
        "summary": "Obter App Team",
        "description": "Obter informações da equipa de uma aplicação",
        "operationId": "getTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      },
      "post": {
        "tags": [
          "Team Manager"
        ],
        "summary": "Adiciona um membro à Team da aplicação",
        "description": "Adiciona um membro à Team da aplicação",
        "operationId": "createTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/teamManager"
        },
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
      ,
      "put": {
        "tags": [
          "Team Manager"
        ],
        "summary": "Editar as permisões do membro de uma Team",
        "description": "Editar as permisões do membro de uma Team",
        "operationId": "editTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/teamManager"
        },
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/app/{appID}/team/{modID}": {
      "delete": {
        "tags": [
          "Team Manager"
        ],
        "summary": "Remover um membro",
        "description": "Remove um membro da Team",
        "operationId": "deleteTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "modID",
            "in": "path",
            "description": "ID do mod",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/team": {
      "get": {
        "tags": [
          "Team"
        ],
        "summary": "Obter Team Apps",
        "description": "Obter todas as aplicações Team que o proprietário do token tem acesso",
        "operationId": "getTeam",
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/team/{appID}/start": {
      "put": {
        "tags": [
          "Team"
        ],
        "summary": "Iniciar Aplicação",
        "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
        "operationId": "startTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/team/{appID}/restart": {
      "put": {
        "tags": [
          "Team"
        ],
        "summary": "Reiniciar Aplicação",
        "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
        "operationId": "restartTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/team/{appID}/stop": {
      "put": {
        "tags": [
          "Team"
        ],
        "summary": "Parar aplicação",
        "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
        "operationId": "stopTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/team/{appID}/commit": {
      "put": {
        "tags": [
          "Team"
        ],
        "summary": "Commit App",
        "description": "Fazer commit de uma aplicação (all não é permitido)",
        "operationId": "commitTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/sendFile"
        },
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/team/{appID}/backup": {
      "get": {
        "tags": [
          "Team"
        ],
        "summary": "Backup App",
        "description": "Obter o backup da aplicação",
        "operationId": "getBackupTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/team/{appID}/logs": {
      "get": {
        "tags": [
          "Team"
        ],
        "summary": "Logs App",
        "description": "Obter os logs da aplicação",
        "operationId": "getLogsTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/team/{appID}/ram": {
      "put": {
        "tags": [
          "Team"
        ],
        "summary": "Mudar RAM do App",
        "description": "Mudar a quantidade de RAM de uma Aplicação",
        "operationId": "setRamTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/setRam"
        },
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    },
    "/team/{appID}/status": {
      "get": {
        "tags": [
          "Team"
        ],
        "summary": "Status App",
        "description": "Obter informações de uma aplicação",
        "operationId": "getStatusTeamApp",
        "parameters": [
          {
            "name": "appID",
            "in": "path",
            "description": "ID da Aplicação ou \"all\" (sem apas) para todos os apps",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation"
          }
        }
      }
    }
  },
  "security": [
    {
      "api-token": []
    }
  ],
  "components": {
    "requestBodies": {
      "sendFile": {
        "content": {
          "multipart/form-data": {
            "schema": {
              "required": [
                "file"
              ],
              "type": "object",
              "properties": {
                "file": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          }
        }
      },
      "setRam": {
        "content": {
          "application/json": {
            "schema": {
              "required": [
                "ramMB"
              ],
              "type": "object",
              "properties": {
                "ramMB": {
                  "type": "number",
                  "minimum": 100
                }
              }
            }
          }
        }
      },
      "teamManager": {
        "description": "Perms:[\"start_app\",\"stop_app\",\"restart_app\",\"logs_app\",\"commit_app\",\"edit_ram\",\"backup_app\",\"status_app\"] ",
        "content": {
          "application/json": {
            "schema": {
              "required": [
                "modID",
                "perms"
              ],
              "type": "object",
              "properties": {
                "modID": {
                  "type": "string"
                },
                "perms": {
                  "type": "array",
                  "items":{
                    "type": "string",
                    "enum": [
                      "start_app",
                      "stop_app",
                      "restart_app",
                      "logs_app",
                      "commit_app",
                      "edit_ram",
                      "backup_app",
                      "status_app"
                    ]
                  }
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "api-token": {
        "type": "apiKey",
        "name": "api-token",
        "in": "header"
      }
    }
  }
}