Home
REST API
Learn how to extend the product with REST APIs.
REST API
Learn about REST API in AppScan Enterprise.
Scan Management REST APIs (Legacy)
Services
These REST web services perform a variety of tasks, particularly providing access to reporting data.
Getting Report results
Learn about using this REST service to get report results.
Requesting report data
This REST service requests a report's data.

REST API
Learn how to extend the product with REST APIs.
- REST API
  Learn about REST API in AppScan Enterprise.
  - Scan Management REST APIs (Legacy)
    - Web services API
      Use an Application Programming Interface (API) through REST web services to perform a variety of tasks, particularly providing access to reporting data.
    - Sample 1: Creating and running a scan using web services
      This sample leads you through creating and running a scan.
    - Sample 2: DAST Scanning through Build Automation
    - Services
      These REST web services perform a variety of tasks, particularly providing access to reporting data.
      - Requesting the web services schema
        This REST service will return the web services schema. The schema is fully annotated to describe the elements and attributes returned by all web services. Please refer to this document regarding XML specifics.
      - Requesting version information
        This REST service will return version information about the Server.
      - Getting Folders
        Learn about using this REST service to get <folder> elements.
      - Running a Scan
        Learn about using this REST service to retrieve scan related information.
      - Getting Report results
        Learn about using this REST service to get report results.
        Requesting a collection of reports
        This REST service requests the collection of reports inside a particular report pack.
        Requesting a single report
        This REST service requests a single report.
        Requesting report data
        This REST service requests a report's data.
        Requesting a report's schema
        This REST service returns the schema for a given report. Each report has a distinct schema because it contains different columns. Schemas for reports are not included in the main web services schema because reports are quite dynamic and can be customized.
        Requesting a collection of issues
        Only available for issue managed reports. This REST service returns a collection of elements representing the 'About This Issue' data accessible via the web UI.
        Requesting collection of issues limiting traffic data
        This API gives an option to truncate http-traffic data or limiting its character from an XML report that is larger in size. Based on the parameter, it is possible to truncate the original HTTP traffic as large report that sometimes affect overhead resources and prevent report generation.
        Requesting a single issue
        This REST service returns a single 'About This Issue' element.
        Custom retrieval of report data using POST
        As in the web UI, data can be retrieved according to a selection of grouping, sorting and filters.
        Custom retrieval of collection of issues using POST
        As in the web UI, data can be retrieved according to a selection of grouping, sorting and filters.
  - AppScan Enterprise REST APIs
  - Defect Tracking System Integration REST API
    Learn how to use built-in Defect Tracking System Integration REST API interface to visualize RESTful web services that are used for submitting defects.
  - API change history
    Track changes made to the REST APIs across product versions.

Requesting report data

This REST service requests a report's data.

By default, the data is returned with no grouping so that the full list of items are returned in the report. Data is returned one page (default is 1000 rows) at a time. The XML that is returned contains the page number and total number of pages, as well as a link to the next page of data.

Service format

To retrieve the first page:

/services/reports/<rid>/data

To retrieve subsequent pages:

/services/reports/<rid>/data/pages/<page>

Parameters

rid - report ID

Optional query string parameters:

mode=all

Returns all report data in one request instead of one page at a time.

Returns

This schema can be requested by adding an optional query string parameter 'metadata=schema'. See Requesting a report's schema.