generatearcherreport.do call initiates the process of generating the Archer report, which contains a token you use to retrieve the report when the processing is complete.
These parameters are optional. However, to avoid returning an oversized report and risking the failures that an unwieldy report can cause, Veracode recommends that you only select the minimum number of parameters necessary for your report.
For example, limit the time window when using
to_date as much as possible and limit the number of IDs added to
app_id_list to make the report creation time faster and the final report size manageable.
|Integer||Application ID of the application for which you wish to pull data. You can find the application ID in the main Archer feed or by using the Results API. In a single call, you cannot use this parameter if you are also using the |
|String||Comma-separated list, with no spaces, of application IDs for which you want to pull data. You can find the application IDs in the main Archer feed or by using the Results API. In a single call, you cannot use this parameter if you are also using the |
|String||Use to select published applications with modifications, either published or mitigated, during the specified time period: |
|String||Specify the beginning of a date range using a |
|String||Specify the end of a date range using |
|String||Specify a scan type: |
Examples use the HTTPie command-line tool.
http --auth-type=veracode_hmac "https://analysiscenter.veracode.com/api/3.0/generatearcherreport.do"
generatearcherreport.do call returns the token string you need to retrieve the report using the
downloadarcherreport.do call. Each user account can only use the five most recently produced tokens to download an Archer report, which means that if you generated 10 reports, you can only use the tokens from the last five reports. All tokens expire after 30 days.
generatearcherreport.do call references the archerreportrequest.xsd schema file. You can use the XSD schema file to validate the XML data.
<?xml version="1.0" encoding="UTF-8"?>
1.0/archerreportrequest.xsd" token="<report token>" archer_report_version="3.0">