Post an API request

To post an API request through the Postman application, do as follows:

1. Under Collections, click the plus button to create a new collection.

   

2. Under the collection, click Add a request.

   

3. Under New Request, use the following syntax to enter your firewall details:

   https://<firewall's IP address>:<firewall's port>/webconsole/APIController
   

   

4. Click Body and select form-data.

   

5. Under Key, enter reqxml.

6. Under Value, use the syntax in the following example to post the request.

   <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>
   

7. Click Send.

To post an API request through the command line of your Linux endpoint or the firewall, do as follows:

1. Open a text editor, such as Notepad, and enter the payload you want to post.

   Here's an example of a request to get the IP hosts:

   <Request>
       <Login>
           <Username><your username></Username>
           <Password><your password></Password>
       </Login>
       <Get>
           <IPHost>
           </IPHost>
       </Get>
   </Request>
   

2. Save the payload file with a .xml extension.

3. Use the following syntax to post the payload:

curl -k https://<firewall's IP address>:<firewall's port>/webconsole/APIController -F "reqxml=<payload file.xml>"