Web-API

Der INETAPP-Server stellt eine Vielzahl von Funktionen über eine Web-API Schnittstelle zur Verfügung. Dazu benötigen die Benutzer die Web API-Zugriffs-Berechtigung. Darüber hinaus kann es erforderlich sein, dass Benutzer auch Berechtigungen für bestimmte weitere Funktionen im System haben müssen.

Die folgende Liste von API-Endpunkten steht dem aktuellen Benutzer zur Verfügung:

WEB-API-EXTENSIONS-LIST

Antwortbereich

Der Antwortbereich der Web API Oberfläche besteht aus der Anfrage-URL, dem Antwortstatus-Code und der Nachricht. Ein Optionsfeld ermöglicht das Umschalten des Vorschaumodus (standardmäßig eingeschaltet).

Wenn die Antwortstatus-Nachricht nicht gesetzt wurde, wird eine generische Nachricht angezeigt (drei Punkte: ...). Dies geschieht normalerweise, wenn ein API-Punkt binäre Daten zurückschickt.

Hinweis: Binäre Datenantworten können dazu führen, dass anstelle einer JSON-Antwort (oder anderer verfügbarer Formate) ein Download-Button angezeigt wird. Die Anfrage wird beim klick auf die Download Schaltfläche erneut ausgelöst. Das bedeutet, dass der Befehl auf dem Server zweimal ausgeführt wird.

Vorschau-Modus

Der Vorschaumodus ist eine Option im Antwortfenster der Web API Oberfläche. Wenn er aktiviert ist, sendet er zusätzliche Informationen an den Server, der dann entscheiden kann, das Ausführen eines bestimmten Befehls nur zu simulieren.

Ob ein Befehl mit tatsächlichen Daten im Vorschaumodus ausgeführt wird, hängt stark vom jeweiligen Befehl ab. Normalerweise ist der Vorschaumodus für potenziell destruktive Befehle wie Löschen sinnvoll.

Authentifizierung

Anfragen an die Web-API erfordern eine ordnungsgemäße Authentifizierung. Viele der vorinstallierten Authentifizierungsanbieter unterstützen das BASIC-Authentifizierungsschema.

# REQUEST
POST /api HTTP/1.1
Authorization: Bearer VGhpcyBpcyBqdXN0IGEgZGVtbyBhY2Nlc3MgdG9rZW4u
Content-Type: application/json

Authentifizierte Sitzungen

Bei der Authentifizierung mit dem BASIC-Authentifizierungsschema wird eine Sitzung erstellt. Es wird empfohlen, diese Sitzung für nachfolgende Anfragen wiederzuverwenden. Andernfalls wird der Server möglicherweise eine große Anzahl von Sitzungen erstellen, die nicht wirklich benötigt werden. Jede Sitzung nimmt Speicherplatz in Anspruch und verlangsamt den Server.

Um dies zu verhindern, gibt es ein zusätzliches Defender Plugin, das nur eine bestimmte Anzahl von Sitzungen innerhalb einer bestimmten Zeit erlaubt. Es sperrt dann den Benutzer und die IP für das Einloggen.

Lösung: Es sollten entweder die Sitzung für eine große Anzahl von aufeinanderfolgenden Anfragen wiederverwendet _oder_ das Token Authentication plugin benutzt werden. Dieses Plugin erstellt keine Sitzungen, obwohl es den Benutzer bei jeder Anfrage anmeldet.