कोर संचालन

डैशबोर्ड डेटा प्राप्त करें (एकीकृत) - /api/dashboard

• एंडपॉइंट: /api/dashboard

• विधि: GET

• विवरण: सर्वर सारांश, समग्र सारांश और चार्ट डेटा सहित एकल एकीकृत प्रतिक्रिया में सभी डैशबोर्ड डेटा पुनः प्राप्त करता है।

• प्रतिक्रिया:

  {
    "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
      }
    ]
  }

• त्रुटि प्रतिक्रियाएं:

  • 500: डैशबोर्ड डेटा प्राप्त करते समय सर्वर त्रुटि

• नोट:

  • यह एंडपॉइंट पिछले /api/servers-summary एंडपॉइंट को एकीकृत करता है (जिसे हटा दिया गया है)
  • overallSummary फ़ील्ड /api/summary के समान डेटा रखता है (जो बाहरी अनुप्रयोगों के लिए बनाए रखा गया है)
  • chartData फ़ील्ड /api/chart-data/aggregated के समान डेटा रखता है (जो अभी भी प्रत्यक्ष पहुंच के लिए मौजूद है)
  • एकल अनुरोध में कई एपीआई कॉल को कम करके बेहतर प्रदर्शन प्रदान करता है
  • इष्टतम प्रदर्शन के लिए सभी डेटा समानांतर में प्राप्त किया जाता है
  • secondsSinceLastBackup फ़ील्ड सभी सर्वर पर अंतिम बैकअप के बाद सेकंड में समय दिखाता है

सभी सर्वर प्राप्त करें - /api/servers

• एंडपॉइंट: /api/servers

• विधि: GET

• विवरण: उनकी मूल जानकारी के साथ सभी सर्वर की सूची पुनः प्राप्त करता है। वैकल्पिक रूप से बैकअप जानकारी शामिल करता है।

• प्रमाणीकरण: मान्य सत्र और CSRF टोकन की आवश्यकता है

• क्वेरी पैरामीटर:

  • includeBackups (वैकल्पिक): प्रत्येक सर्वर के लिए बैकअप जानकारी शामिल करने के लिए true पर सेट करें

• प्रतिक्रिया (पैरामीटर के बिना):

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

• प्रतिक्रिया (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
    }
  ]

• त्रुटि प्रतिक्रियाएं:

  • 401: अनधिकृत - अमान्य सत्र या CSRF टोकन
  • 500: सर्वर त्रुटि प्राप्त करते समय सर्वर

• नोट:

  • उपनाम और नोट फ़ील्ड सहित सर्वर जानकारी लौटाता है
  • जब includeBackups=true, यूआरएल और पासवर्ड स्थिति के साथ सर्वर-बैकअप संयोजन लौटाता है
  • पिछले /api/servers-with-backups एंडपॉइंट को एकीकृत करता है (जिसे हटा दिया गया है)
  • सर्वर चयन, प्रदर्शन और कॉन्फ़िगरेशन उद्देश्यों के लिए उपयोग किया जाता है
  • सर्वर में संग्रहीत पासवर्ड संकेत देने के लिए hasPassword फ़ील्ड शामिल करता है

सर्वर विवरण प्राप्त करें - /api/servers/:id

• एंडपॉइंट: /api/servers/:id

• विधि: GET

• विवरण: एक विशिष्ट सर्वर के बारे में जानकारी पुनः प्राप्त करता है। मूल सर्वर जानकारी या बैकअप और चार्ट डेटा सहित विस्तृत जानकारी लौटा सकता है।

• प्रमाणीकरण: मान्य सत्र और CSRF टोकन की आवश्यकता है

• पैरामीटर:

  • id: सर्वर पहचानकर्ता

• क्वेरी पैरामीटर:

  • includeBackups (वैकल्पिक): बैकअप डेटा शामिल करने के लिए true पर सेट करें
  • includeChartData (वैकल्पिक): चार्ट डेटा शामिल करने के लिए true पर सेट करें

• प्रतिक्रिया (पैरामीटर के बिना):

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

• प्रतिक्रिया (पैरामीटर के साथ):

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

• त्रुटि प्रतिक्रियाएं:

  • 401: अनधिकृत - अमान्य सत्र या CSRF टोकन
  • 404: सर्वर नहीं मिला
  • 500: सर्वर विवरण प्राप्त करते समय सर्वर त्रुटि

• नोट:

  • कोई क्वेरी पैरामीटर प्रदान नहीं किए जाने पर मूल सर्वर जानकारी लौटाता है
  • includeBackups या includeChartData में से किसी भी एक को true पर सेट करना बैकअप और चार्टडेटा सहित पूर्ण सर्वर डेटा लौटाता है
  • सर्वर सेटिंग्स और विस्तार दृश्यों के लिए उपयोग किया जाता है

सर्वर अपडेट करें - /api/servers/:id

• एंडपॉइंट: /api/servers/:id

• विधि: PATCH

• विवरण: उपनाम, नोट और सर्वर यूआरएल सहित सर्वर विवरण अपडेट करता है।

• प्रमाणीकरण: मान्य सत्र और CSRF टोकन की आवश्यकता है

• पैरामीटर:

  • id: सर्वर पहचानकर्ता

• अनुरोध निकाय:

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

• प्रतिक्रिया:

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

• त्रुटि प्रतिक्रियाएं:

  • 401: अनधिकृत - अमान्य सत्र या CSRF टोकन
  • 404: सर्वर नहीं मिला
  • 500: अपडेट करते समय सर्वर त्रुटि

• नोट:

  • सर्वर उपनाम, नोट और सर्वर यूआरएल अपडेट करता है
  • सभी फ़ील्ड वैकल्पिक हैं
  • सभी फ़ील्ड के लिए खाली स्ट्रिंग की अनुमति है

सर्वर हटाएं - /api/servers/:id

• एंडपॉइंट: /api/servers/:id

• विधि: DELETE

• विवरण: एक सर्वर और इसके सभी संबद्ध बैकअप को हटा देता है।

• प्रमाणीकरण: मान्य सत्र और CSRF टोकन की आवश्यकता है

• पैरामीटर:

  • id: सर्वर पहचानकर्ता

• प्रतिक्रिया:

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

• त्रुटि प्रतिक्रियाएं:

  • 401: अनधिकृत - अमान्य सत्र या CSRF टोकन
  • 404: सर्वर नहीं मिला
  • 500: हटाते समय सर्वर त्रुटि

• नोट:

  • यह संचालन अपरिवर्तनीय है
  • सर्वर के साथ संबद्ध सभी बैकअप डेटा स्थायी रूप से हटा दिया जाएगा
  • सर्वर रिकॉर्ड स्वयं को भी हटा दिया जाएगा
  • हटाए गए बैकअप और सर्वर की गिनती लौटाता है

अतिदेय जानकारी के साथ सर्वर डेटा प्राप्त करें - /api/detail/:serverId

• एंडपॉइंट: /api/detail/:serverId

• विधि: GET

• विवरण: अतिदेय बैकअप स्थिति सहित विस्तृत सर्वर जानकारी प्राप्त करता है।

• पैरामीटर:

  • serverId: सर्वर पहचानकर्ता

• प्रतिक्रिया:

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

• त्रुटि प्रतिक्रियाएँ:

  • 404: सर्वर नहीं मिला
  • 500: सर्वर विवरण प्राप्त करने में सर्वर त्रुटि

• नोट:

  • अतिदेय बैकअप जानकारी के साथ सर्वर डेटा लौटाता है
  • प्रत्येक अतिदेय बैकअप का विवरण और टाइमस्टैम्प शामिल करता है
  • अतिदेय बैकअप प्रबंधन और निगरानी के लिए उपयोग किया जाता है

डुप्लिकेट सर्वर प्राप्त करें - /api/servers/duplicates

• एंडपॉइंट: /api/servers/duplicates

• विधि: GET

• विवरण: मशीन आईडी के आधार पर डुप्लिकेट सर्वर की सूची प्राप्त करता है। डुप्लिकेट सर्वर वे सर्वर हैं जो समान मशीन आईडी साझा करते हैं लेकिन डेटाबेस में अलग रिकॉर्ड के रूप में संग्रहीत किए जाते हैं।

• प्रमाणीकरण: मान्य सत्र, CSRF टोकन और व्यवस्थापक एक्सेस की आवश्यकता है

• प्रतिक्रिया:

  [
    {
      "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
        }
      ]
    }
  ]

• त्रुटि प्रतिक्रियाएँ:

  • 401: अनधिकृत - अमान्य सत्र या CSRF टोकन
  • 403: व्यवस्थापक एक्सेस आवश्यक
  • 500: डुप्लिकेट सर्वर प्राप्त करने में सर्वर त्रुटि

• नोट:

  • केवल व्यवस्थापक इस एंडपॉइंट तक पहुंच सकते हैं
  • समान मशीन आईडी साझा करने वाले सर्वर समूह लौटाता है
  • प्रत्येक समूह में समान मशीन आईडी वाले सभी सर्वर शामिल होते हैं
  • डुप्लिकेट सर्वर रिकॉर्ड की पहचान और मर्ज करने के लिए उपयोग किया जाता है
  • प्रत्येक डुप्लिकेट के लिए सर्वर विवरण और बैकअप गणना शामिल करता है

सर्वर मर्ज करें - /api/servers/merge

• एंडपॉइंट: /api/servers/merge

• विधि: POST

• विवरण: लक्ष्य सर्वर में कई सर्वर मर्ज करता है। स्रोत सर्वर के सभी बैकअप लक्ष्य सर्वर में स्थानांतरित कर दिए जाते हैं और स्रोत सर्वर हटा दिए जाते हैं।

• प्रमाणीकरण: मान्य सत्र, CSRF टोकन और व्यवस्थापक एक्सेस की आवश्यकता है

• अनुरोध निकाय:

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

• प्रतिक्रिया:

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

• त्रुटि प्रतिक्रियाएँ:

  • 400: अमान्य अनुरोध निकाय, आवश्यक फ़ील्ड गायब या लक्ष्य सर्वर मर्ज करने के लिए सर्वर सूची में है
  • 401: अनधिकृत - अमान्य सत्र या CSRF टोकन
  • 403: व्यवस्थापक एक्सेस आवश्यक
  • 500: मर्ज संचालन के दौरान सर्वर त्रुटि

• नोट:

  • केवल व्यवस्थापक मर्ज संचालन कर सकते हैं
  • लक्ष्य सर्वर मर्ज करने के लिए सर्वर सूची में नहीं होना चाहिए
  • स्रोत सर्वर के सभी बैकअप लक्ष्य सर्वर में स्थानांतरित कर दिए जाते हैं
  • मर्ज किए गए सर्वर पर समान backup_name के लिए डुप्लिकेट backup_id मानों को सबसे हाल के बैकअप पंक्ति से आईडी पर सामान्यीकृत किया जाता है
  • सफल मर्ज के बाद स्रोत सर्वर हटा दिए जाते हैं
  • यह संचालन अपरिवर्तनीय है
  • डुप्लिकेट सर्वर रिकॉर्ड को एकीकृत करने के लिए उपयोग किया जाता है
  • सत्यापित करता है कि oldServerIds एक गैर-खाली सरणी है
  • सत्यापित करता है कि targetServerId प्रदान किया गया है और एक स्ट्रिंग है