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
Anfragen können in gewissem Umfang angepasst werden: Benutzer können die HTTP-Methode (POST
, GET
, HEAD
...) festlegen, dynamische Teile der URL aktualisieren, z.B. IDs, die bestimmte WebAPI-Kontexte ansprechen, Anfrage-Header sowie das Anfrage-JSON setzen.
Der URL-Pfad ist in der Regel nicht editierbar, mit Ausnahme der Teile, die z.B. IDs akzeptieren. Wenn Sie ID-Teile bearbeiten und in der Seitennavigation weiter navigieren, werden diese ID-Teile für die aktuelle Seite gespeichert, so dass Sie nahtlos vor- und zurückspringen können. Das erneute Senden einer Anfrage erfolgt über die Schaltfläche Senden
.
Über das Optionsmenü neben der Schaltfläche Senden
können Sie den Vorschaumodus aktivieren, den JSON-Dateneingabebereich und den Bereich für zusätzliche HTTP Anfrage-Header einblenden.
Zusätzliche Benutzerdefinierte HTTP Header können mit einer Anfrage mitgeschickt werden, wenn ein WebAPI-Endpunkt dies erfordert. Dies können z.B. Bearer Token sein.
Der Bereich JSON-Anfragedaten senden ermöglicht das Mitsenden einer JSON-Anfrage, die für einen bestimmten WebAPI-Endpunkt erforderlich ist. Hinweise auf das benötigte JSON werden in der Regel auf der Hilfeseite unterhalb des Antwortbereichs gegeben.
Hinweis: Einige HTTP-Methoden unterstützen das Senden von JSON-Daten nicht. Der Bereich ist dann deaktiviert.
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.
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.
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
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.