Weiter zum Hauptinhalt

Cron-Dienstverwaltung

Cron-Konfiguration abrufen - /api/cron-config​

  • Endpunkt: /api/cron-config

  • Methode: GET

  • Beschreibung: Ruft die aktuelle Konfiguration des Cron-Dienstes ab.

  • Authentifizierung: Erfordert eine gültige Sitzung und ein CSRF-Token

  • Antwort:

    {
      "cronExpression": "*/20 * * * *",
      "enabled": true
    }

  • Fehlerantworten:

    • 500: Abrufen der Cron-Konfiguration fehlgeschlagen

  • Hinweise:

    • Gibt die aktuelle Cron-Dienstkonfiguration zurück
    • Enthält Cron-Ausdruck und aktivierten Status
    • Wird für das Management des Cron-Dienstes verwendet

Cron-Konfiguration aktualisieren - /api/cron-config​

  • Endpunkt: /api/cron-config

  • Methode: POST

  • Beschreibung: Aktualisiert die Konfiguration des Cron-Dienstes.

  • Authentifizierung: Erfordert eine gültige Sitzung und ein CSRF-Token

  • Anforderungstext:

    {
      "interval": "20min"
    }

  • Antwort:

    {
      "success": true
    }

  • Verfügbare Intervalle: "disabled", "1min", "5min", "10min", "15min", "20min", "30min", "1hour", "2hours"

  • Fehlerantworten:

    • 400: Intervall ist erforderlich
    • 500: Aktualisierung der Cron-Konfiguration fehlgeschlagen

  • Hinweise:

    • Aktualisiert die Cron-Dienstkonfiguration
    • Validiert das Intervall gegen zulässige Optionen
    • Beeinflusst die Häufigkeit der Überprüfung auf überfällige Sicherungen

Cron-Dienst-Proxy - /api/cron/*​

  • Endpunkt: /api/cron/*

  • Methode: GET, POST

  • Beschreibung: Leitet Anfragen an den Cron-Dienst weiter. Dieser Endpunkt leitet alle Anfragen an den Cron-Dienst weiter, der auf einem separaten Port ausgeführt wird.

  • Authentifizierung: Erfordert gültige Sitzung und CSRF-Token. GET ist für authentifizierte Benutzer erlaubt; POST (Start/Stop/Auslösen/Neu laden) erfordert einen Administrator.

  • Parameter:

    • *: Jeder Pfad, der an den Cron-Dienst weitergeleitet wird

  • Antwort: Hängt vom abgerufenen Cron-Dienstendpunkt ab

  • Fehlerantwort (503):

    {
      "error": "Cron service is not running",
      "message": "The cron service is not available. Please start it with: npm run cron:start"
    }

  • Hinweise:

    • Leitet Anfragen an den Cron-Dienst auf 127.0.0.1 weiter
    • Leitet CRON_SERVICE_SECRET als X-Cron-Service-Secret weiter, wenn gesetzt
    • Gibt 503 zurück, wenn der Cron-Dienst nicht verfügbar ist
    • Unterstützt sowohl GET- als auch POST-Methoden
    • Wird für das Management des Cron-Dienstes über die Weboberfläche verwendet
    • POST /trigger/daily-summary-dispatch wird vom Cron-Dienst abgelehnt; verwenden Sie stattdessen /api/configuration/daily-summary/send
    • POST /trigger/database-compact führt die wöchentliche Komprimierung sofort aus (verwaiste Sicherungen/Server und Benachrichtigungseinstellungen sowie SQLite VACUUM)