Pular para o conteúdo principal

Operações Principais

Obter Dados do Painel (Consolidado) - /api/dashboard​

  • Endpoint: /api/dashboard

  • Método: GET

  • Descrição: Recupera todos os dados do painel em uma única resposta consolidada, incluindo resumos de servidores, resumo geral e dados do gráfico.

  • Resposta:

    {
      "serversSummary": [
        {
          "id": "server-id",
          "name": "Server Name",
          "lastBackupDate": "2024-03-20T10:00:00Z",
          "lastBackupStatus": "Success",
          "lastBackupDuration": "00:38:31",
          "lastBackupListCount": 10,
          "lastBackupName": "Backup Name",
          "lastBackupId": "backup-id",
          "backupCount": 15,
          "totalWarnings": 5,
          "totalErrors": 0,
          "availableBackups": ["v1", "v2", "v3"],
          "isBackupOverdue": false,
          "notificationEvent": "all",
          "expectedBackupDate": "2024-03-21T10:00:00Z",
          "expectedBackupElapsed": "2 hours ago",
          "lastOverdueCheck": "2024-03-20T12:00:00Z",
          "lastNotificationSent": "N/A"
        }
      ],
      "overallSummary": {
        "totalServers": 3,
        "totalBackups": 9,
        "totalUploadedSize": 2397229507,
        "totalStorageUsed": 43346796938,
        "totalBackupSize": 126089687807,
        "overdueBackupsCount": 2,
        "secondsSinceLastBackup": 7200
      },
      "chartData": [
        {
          "date": "20/03/2024",
          "isoDate": "2024-03-20T10:00:00Z",
          "uploadedSize": 1024000,
          "duration": 45,
          "fileCount": 1500,
          "fileSize": 2048000,
          "storageSize": 3072000,
          "backupVersions": 5
        }
      ]
    }

  • Respostas de Erro:

    • 500: Erro do servidor ao buscar dados do painel

  • Observações:

    • Este endpoint consolida o endpoint anterior /api/servers-summary (que foi removido)
    • O campo overallSummary contém os mesmos dados que /api/summary (mantido para aplicações externas)
    • O campo chartData contém os mesmos dados que /api/chart-data/aggregated (ainda existente para acesso direto)
    • Oferece melhor desempenho ao reduzir múltiplas chamadas à API para uma única solicitação
    • Todos os dados são recuperados em paralelo para desempenho ideal
    • O campo secondsSinceLastBackup mostra o tempo em segundos desde o último backup em todos os servidores

Obter Todos os Servidores - /api/servers​

  • Endpoint: /api/servers

  • Método: GET

  • Descrição: Recupera uma lista de todos os servidores com suas informações básicas. Opcionalmente inclui informações de backup.

  • Autenticação: Requer sessão válida e token CSRF

  • Parâmetros de Consulta:

    • includeBackups (opcional): Defina como true para incluir informações de backup para cada servidor

  • Resposta (sem parâmetros):

    [
      {
        "id": "server-id",
        "name": "Server Name",
        "alias": "Server Alias",
        "note": "Additional notes about the server"
      }
    ]

  • Resposta (com includeBackups=true):

    [
      {
        "id": "server-id",
        "name": "Server Name",
        "backupName": "Backup Name",
        "server_url": "http://localhost:8200",
        "alias": "Server Alias",
        "note": "Additional notes about the server",
        "hasPassword": true
      }
    ]

  • Respostas de Erro:

    • 401: Não autorizado - Sessão ou token CSRF inválido
    • 500: Erro do servidor ao buscar servidores

  • Observações:

    • Retorna informações do servidor, incluindo campos de apelido e observação
    • Quando includeBackups=true, retorna combinações de servidor-backup com URLs e status de senha
    • Consolida o endpoint anterior /api/servers-with-backups (que foi removido)
    • Utilizado para seleção, exibição e configuração de servidores
    • Inclui o campo hasPassword para indicar se o servidor possui senha armazenada

Obter Detalhes do Servidor - /api/servers/:id​

  • Endpoint: /api/servers/:id

  • Método: GET

  • Descrição: Recupera informações sobre um servidor específico. Pode retornar informações básicas do servidor ou informações detalhadas, incluindo backups e dados do gráfico.

  • Autenticação: Requer sessão válida e token CSRF

  • Parâmetros:

    • id: o identificador do servidor

  • Parâmetros de Consulta:

    • includeBackups (opcional): Defina como true para incluir dados de backup
    • includeChartData (opcional): Defina como true para incluir dados do gráfico

  • Resposta (sem parâmetros):

    {
      "id": "server-id",
      "name": "Server Name",
      "alias": "Server Alias",
      "note": "Additional notes about the server",
      "server_url": "http://localhost:8200"
    }

  • Resposta (com parâmetros):

    {
      "id": "server-id",
      "name": "Server Name",
      "alias": "Server Alias",
      "note": "Additional notes about the server",
      "server_url": "http://localhost:8200",
      "backups": [
        { ... }
      ],
      "chartData": [
        { ... }
      ]
    }

  • Respostas de Erro:

    • 401: Não autorizado - Sessão ou token CSRF inválido
    • 404: Servidor não encontrado
    • 500: Erro do servidor ao buscar detalhes do servidor

  • Observações:

    • Retorna informações básicas do servidor quando nenhum parâmetro de consulta é fornecido
    • Definir includeBackups ou includeChartData como true retorna todos os dados do servidor, incluindo backups e chartData
    • Utilizado para visualizações de configurações e detalhes do servidor

Atualizar Servidor - /api/servers/:id​

  • Endpoint: /api/servers/:id

  • Método: PATCH

  • Descrição: Atualiza os detalhes do servidor, incluindo apelido, observação e URL do servidor.

  • Autenticação: Requer sessão válida e token CSRF

  • Parâmetros:

    • id: o identificador do servidor

  • Corpo da Solicitação:

    {
      "server_url": "http://localhost:8200",
      "alias": "Server Alias",
      "note": "Additional notes about the server"
    }

  • Resposta:

    {
      "message": "Server updated successfully",
      "serverId": "server-id",
      "server_url": "http://localhost:8200",
      "alias": "Server Alias",
      "note": "Additional notes about the server"
    }

  • Respostas de Erro:

    • 401: Não autorizado - Sessão ou token CSRF inválido
    • 404: Servidor não encontrado
    • 500: Erro do servidor durante a atualização

  • Observações:

    • Atualiza apelido, observação e URL do servidor
    • Todos os campos são opcionais
    • Cadeias de caracteres vazias são permitidas para todos os campos

Excluir Servidor - /api/servers/:id​

  • Endpoint: /api/servers/:id

  • Método: DELETE

  • Descrição: Exclui um servidor e todos os backups associados.

  • Autenticação: Requer sessão válida e token CSRF

  • Parâmetros:

    • id: o identificador do servidor

  • Resposta:

    {
      "message": "Successfully deleted server and 15 backups",
      "status": 200,
      "changes": {
        "backupChanges": 15,
        "serverChanges": 1
      }
    }

  • Respostas de Erro:

    • 401: Não autorizado - Sessão inválida ou token CSRF inválido
    • 404: Servidor não encontrado
    • 500: Erro do servidor durante a exclusão

  • Notas:

    • Esta operação é irreversível
    • Todos os dados de backup associados ao servidor serão permanentemente excluídos
    • O próprio registro do servidor também será removido
    • Retorna a contagem de backups e servidores excluídos

Obter Dados do Servidor com Informações de Atraso - /api/detail/:serverId​

  • Endpoint: /api/detail/:serverId

  • Método: GET

  • Descrição: Recupera informações detalhadas do servidor, incluindo status de backup atrasado.

  • Parâmetros:

    • serverId: o identificador do servidor

  • Resposta:

    {
      "server": {
        "id": "server-id",
        "name": "Server Name",
        "backups": [...]
      },
      "overdueBackups": [
        {
          "serverName": "Server Name",
          "backupName": "Backup Name",
          "lastBackupDate": "2024-03-20T10:00:00Z",
          "lastNotificationSent": "2024-03-20T12:00:00Z",
          "notificationEvent": "all",
          "expectedBackupDate": "2024-03-21T10:00:00Z",
          "expectedBackupElapsed": "2 hours ago"
        }
      ],
      "lastOverdueCheck": "2024-03-20T12:00:00Z"
    }

  • Respostas de Erro:

    • 404: Servidor não encontrado
    • 500: Erro do servidor ao buscar detalhes do servidor

  • Notas:

    • Retorna os dados do servidor com informações de backup atrasado
    • Inclui detalhes e carimbos de data/hora de backups atrasados
    • Utilizado para gerenciamento e monitoramento de backups atrasados

Obter Servidores Duplicados - /api/servers/duplicates​

  • Endpoint: /api/servers/duplicates

  • Método: GET

  • Descrição: Recupera uma lista de servidores duplicados com base no ID da máquina. Servidores duplicados são servidores que compartilham o mesmo ID da máquina, mas são armazenados como registros separados no banco de dados.

  • Autenticação: Requer sessão válida, token CSRF e acesso de administrador

  • Resposta:

    [
      {
        "machineId": "machine-id-123",
        "servers": [
          {
            "id": "server-id-1",
            "name": "Server Name 1",
            "alias": "Server Alias 1",
            "server_url": "http://localhost:8200",
            "backupCount": 5
          },
          {
            "id": "server-id-2",
            "name": "Server Name 2",
            "alias": "Server Alias 2",
            "server_url": "http://localhost:8200",
            "backupCount": 3
          }
        ]
      }
    ]

  • Respostas de Erro:

    • 401: Não autorizado - Sessão inválida ou token CSRF inválido
    • 403: Acesso de administrador necessário
    • 500: Erro do servidor ao buscar servidores duplicados

  • Notas:

    • Apenas administradores podem acessar este endpoint
    • Retorna grupos de servidores que compartilham o mesmo ID de máquina
    • Cada grupo contém todos os servidores com o mesmo ID de máquina
    • Utilizado para identificar e mesclar registros duplicados de servidores
    • Inclui detalhes do servidor e contagem de backups para cada duplicado

Mesclar Servidores - /api/servers/merge​

  • Endpoint: /api/servers/merge

  • Método: POST

  • Descrição: Mescla vários servidores em um servidor de destino. Todos os backups dos servidores de origem são transferidos para o servidor de destino, e os servidores de origem são excluídos.

  • Autenticação: Requer sessão válida, token CSRF e acesso de administrador

  • Corpo da Requisição:

    {
      "oldServerIds": ["server-id-1", "server-id-2"],
      "targetServerId": "server-id-3"
    }

  • Resposta:

    {
      "success": true,
      "message": "Successfully merged 2 server(s) into target server",
      "backupIdsNormalized": 1
    }

  • Respostas de Erro:

    • 400: Corpo da requisição inválido, campos obrigatórios ausentes ou servidor de destino está na lista de servidores a mesclar
    • 401: Não autorizado - Sessão inválida ou token CSRF inválido
    • 403: Acesso de administrador necessário
    • 500: Erro do servidor durante a operação de mesclagem

  • Notas:

    • Apenas administradores podem realizar operações de mesclagem
    • O servidor de destino não deve estar na lista de servidores a mesclar
    • Todos os backups dos servidores de origem são transferidos para o servidor de destino
    • Valores duplicados backup_id para o mesmo backup_name no servidor mesclado são normalizados para o ID da linha de backup mais recente
    • Servidores de origem são excluídos após mesclagem bem-sucedida
    • Esta operação é irreversível
    • Usado para consolidar registros de servidores duplicados
    • Valida que oldServerIds é um array não vazio
    • Valida que targetServerId é fornecido e é uma string