Datenbankverwaltung

Diese Endpoints verwalten die zugrundeliegende IDIAL-Datenbank. Sie sind ausschließlich für administrative und Entwicklungszwecke vorgesehen.

warnung

Diese Endpoints führen destruktive Operationen durch. In Produktivumgebungen mit äußerster Vorsicht verwenden.

POST /create/dummy-db

Erstellt eine vorab befüllte Testdatenbank mit Beispiel-Inventareinträgen, PKI-Konfigurationen und Wartungsfenstern. Nützlich für Entwicklung und Integrationstests.

Authentifizierung: X-API-Key erforderlich

Anfrage

curl -X POST http://localhost:5000/create/dummy-db \
  -H "X-API-Key: your-api-key"

Antwort 200

{"success": true, "execution": "ok", "error": "", "result": null}

Antwortfelder

Feld	Typ	Beschreibung
success	boolean	Gibt an, ob die Operation erfolgreich war.
execution	string	Ausführungsstatus.
error	string	Fehlermeldung, falls die Operation fehlgeschlagen ist.
result	object | null	Zusätzliche Ergebnisdaten.

---

DELETE /sql/{totp_code}

Löscht die gesamte IDIAL-Datenbank. Diese Operation ist nicht umkehrbar. Der Endpoint ist durch ein Time-based One-Time Password (TOTP), das aus dem API-Key abgeleitet wird, gegen versehentliches Löschen geschützt.

Authentifizierung: X-API-Key erforderlich

gefahr

Dieser Endpoint löscht dauerhaft alle Daten in der IDIAL-Datenbank, einschließlich aller Inventareinträge, PKI-Konfigurationen, Wartungsfenster, Zertifikate und Benutzerzugangsdaten. Diese Aktion kann nicht rückgängig gemacht werden. Stellen Sie sicher, dass vor dem Aufruf dieses Endpoints ein Backup vorhanden ist.

TOTP-Generierung

Der Pfadparameter {totp_code} ist ein 6-stelliger TOTP-Code, der aus dem IDIAL-API-Key als TOTP-Secret generiert wird. Verwenden Sie eine Standard-TOTP-Bibliothek (RFC 6238) mit dem API-Key-Wert als Secret.

Anfrage

curl -X DELETE http://localhost:5000/sql/123456 \
  -H "X-API-Key: your-api-key"

Pfadparameter

Parameter	Typ	Beschreibung
totp_code	string	Aktueller 6-stelliger TOTP-Code, abgeleitet aus dem API-Key.

Antwort 200

{"success": true, "execution": "ok", "error": "", "result": null}

Antwort 401

Wird zurückgegeben, wenn der TOTP-Code ungültig oder abgelaufen ist.

{"error": "Invalid TOTP code"}