Accessing the Interactive API Documentation Page
Use the interactive API documentation page to access technical details for the RESTful APIs and experiment with making API requests to your server.
The API documentation user interface provides descriptions and the ability to use the following REST API interfaces:
Table 1: REST API Interfaces
Create, update, and remove custom actions for rules.
View event and flow properties, create event and flow searches, and manage searches.
Returns a list of all assets in the model. You can also list all available asset property types and saved searches, and update an asset.
Log out and invalidate the current session.
View and manage tenants, domains, and JSA extensions.
Install and manage applications that are created by using the GUI Application Framework Software Development Kit.
Returns a list of API capabilities.
Retrieves assets, vulnerabilities, networks, open services, networks, and filters. You can also create or update remediation tickets.
View and manage reference data collections.
View, create, or start a remote scan that is related to a scan profile.
View, update, and close offenses. You can also add notes and manage offense closing reasons.
Manage server hosts, network interfaces, and firewall rules.
- To access the interactive API documentation interface, enter the following URL in your web browser: https://ConsoleIPaddress/api_doc/.
- Click the arrow icon beside the API version you want to
9.0 is the latest version for JSA 7.3.1.
- Go to the endpoint that you want to access.
- Read the endpoint documentation and complete the request parameters.
- Click Try it out to send the API request to
your console and receive a properly formatted HTTPS response.
When you click Try it out, the action is performed on the JSA system. Not all actions can be reversed, for example, you cannot reopen an offense after you close it.
- Review and gather the information that you need to integrate with JSA.