Schnittstellen

Der opsi-Server verfügt über mehrere Schnittstellen, die verschiedene Funktionen erfüllen. Benutzer mit administrativem Zugriff auf den opsi-Server (siehe Kapitel Berechtigungen) können alle Endpunkte über https://<opsi-server>:4447/docs einsehen und sogar ausführen.

API-Endpunkte für *opsiconfd*
Abbildung 1. API-Endpunkte für opsiconfd

JSON-RPC-API

Die Daten des Servers können Sie über die JSON-RPC-Schnittstelle manipulieren. Eine genau Beschreibung der JSON-RPC-API finden Sie im nächsten Kapitel JSON-RPC-API.

WebGUI-Schnittstelle

Wenn das opsiconfd-Addon WebGUI installiert ist (siehe Kapitel opsi-WebGUI), dann wird der Server um eine REST-API erweitert. Diese ist speziell an die Bedürfnisse des WebGUI angepasst.

Sonstige API-Endpunkte

  • /status: Einfache Statusausgabe für Monitoring-Werkzeuge; Kann ohne Anmeldung verwendet werden.

status: ok
version: 4.3.0.104 [python-opsi-common=4.3.0.73]
date: 2023-11-10T15:50:48+01:00
node: opsi-acme-43_opsi-server_1
fqdn: opsi.acme.corp
redis-status: ok
redis-error:
redis-mem: 32911240
redis-mem-total: 36806536
ssl-ca-valid-days: 713
ssl-cert-valid-days: 73