Eine API-Anfrage senden
Sie können API-Anfragen über Webbrowser, die Linux-Befehlszeilenschnittstelle Ihres Endpunkts oder der Firewall oder über Anwendungen wie Postman senden.
Die folgenden Beispiele zeigen, wie man API-Anfragen mit Postman und der Linux-Befehlszeile sendet.
Um eine API-Anfrage über die Postman-Anwendung zu senden, gehen Sie wie folgt vor:
-
Unter Sammlungen: Klicken Sie auf die Plus-Schaltfläche, um eine neue Sammlung zu erstellen.
-
Klicken Sie unter der Kollektion Anfrage hinzufügen.
-
Unter Neue Anfrage: Verwenden Sie die folgende Syntax, um Ihre Firewall-Details einzugeben:
https://<firewall's IP address>:<firewall's port>/webconsole/APIController
-
Klicken Körper und auswählen Formulardaten.
-
Unter Schlüssel, eingeben
reqxml. -
Unter Wert: Verwenden Sie die Syntax im folgenden Beispiel, um die Anfrage zu senden.
<Request> <Login> <Username><your username></Username> <Password><your password></Password> </Login> <Set operation="add"> <IPHost> <Name>IPaddress</Name> <IPFamily>IPv4</IPFamily> <HostType>IP</HostType> <IPAddress>1.1.1.1</IPAddress> </IPHost> </Set> </Request> -
Klicken Schicken.
Um eine API-Anfrage über die Befehlszeile Ihres Linux-Endpunkts oder der Firewall zu senden, gehen Sie wie folgt vor:
-
Öffnen Sie einen Texteditor, zum Beispiel Notepad, und geben Sie die Nutzlast ein, die Sie veröffentlichen möchten.
Hier ist ein Beispiel für eine Anfrage zum Abrufen der IP-Hosts:
<Request> <Login> <Username>Jane</Username> <Password>PQR@!xyz</Password> </Login> <Get> <IPHost> </IPHost> </Get> </Request> -
Speichern Sie die Nutzdatendatei mit einem
.xmlVerlängerung. - Verwenden Sie die folgende Syntax, um die Nutzdaten zu senden:
curl -k https://<firewall's IP address>:<firewall's port>/webconsole/APIController -F "reqxml=<{payload file.xml}" Beispiel
curl -k https://172.16.16.16:4444/webconsole/APIController -F "reqxml=<FileXYZ.xml"