You configure the API wrapper parameters to specify your Veracode API credentials, the actions to perform, and to add parameters.
- You have installed the Veracode Java API wrapper.
- You have generated Veracode API credentials.
- You have installed the required software listed on the Veracode-Authored Integrations page.
To enter required parameters to run the API wrapper functions:
Use the optional parameter -inputfilepath to provide the filepath of a CSV file from which to read additional command-line arguments. The correct format of the CSV file is to enter the parameter names in the first row and the corresponding values of those parameters in the subsequent rows.
You can use inputfilepath to make multiple calls to the API specified by the action. In the CSV file, use one row to specify the parameters for each call. For an example, see createuser.do.
The wrapper returns a zero (integer) exit code when a command succeeds.
The wrapper returns a non-zero (integer) exit codes when a command fails:
- 1 = Invalid input
- 2 = API internal error
- 3 = Incorrect file format of the CSV file referred to in the -inputfilepath parameter
- 4 = The scan did not pass policy compliance. This code only applies to an uploadandscan composite action that specifies the scantimeout parameter.
The Veracode API wrappers return errors for missing required parameters and unrecognized parameters. The API wrappers do not return errors on defined API parameters that are not valid for use with the specified action. For example, if a Veracode API wrapper takes sandboxid as an optional parameter and you supply sandboxname in error, the API wrapper ignores sandboxname and executes. You can verify the list of valid parameters in the console or the XML API documentation.
You can also reference the Java API wrapper from Eclipse.