Working With REST Parameters

Applies to ReadyAPI 3.57, last modified on December 20, 2024
Request parameters

Click the image to enlarge it.

You can organize your REST parameters in the following ways:

Add parameters

To add a REST parameter, click . ReadyAPI will add a new line to the Parameters table. Specify the parameter name and its value.

If you have a REST URL, you can add all the parameters by using that URL. Click  and enter the URL in the follow-up dialog. ReadyAPI will analyze the request and add all its parameters to the table.

Tip: To insert project, global or other ReadyAPI properties to a property’s name or value, use the property expansion.

Reset parameters

To reset parameters to the default values, click . ReadyAPI will reset all the parameters to their default values. Parameters added manually do not have default values.

Reorganize parameters

To change the order of parameters in a request, select the parameter you want to move and click or . If parameters have the same type and are located on the same level, ReadyAPI will use them in the order they are listed. This may be important for a service, so make sure to use the correct parameter order.

Remove parameters

To remove a parameter, select it and click . Confirm that you want to delete the parameter.

Configure advanced options

To modify additional parameter options, expand the Advanced options section at the bottom of the parameter editor:

REST testing in ReadyAPI: Advanced options in the Paramater editor

Click the image to enlarge it.

Use these options to ensure the correct parameter definitions are used in generated WADL files. You can also use custom encoding to ensure the server understands the parameter.

Parameter Options

Click the image to enlarge it.

Option Description
Level

Specifies on which level the parameter is defined. Parameters of the Resource level appear in requests of all the child methods. Parameters of the Method level are specific for a particular method and appear only in requests of this method.

Required

If selected, ReadyAPI adds the parameter to the query string even if the parameter does not have a value.
Default value: enabled.

Type

Sets the XMLSchema parameter type.

Options

A list of options that can be used in the request’s Form editor. The Form editor displays the extra data added for the parameter as a drop-down list:

Show image

Description

The parameter description. Does not affect the request execution.

Disable Encoding

If selected, the parameter is not encoded.

Submit form-data values

Form data of the content type multipart/form-data can be simulated by setting individual parameters to be read from a file.

  1. Select a parameter.

  2. Change the parameter value to file:<filepath>.

The content of the file will be inserted into the outgoing request.

Defining a parameter on the resource level means that it is inherited by all method nodes under it and by all requests under the method nodes.

Defining it on the method level only propagates the parameters to the requests; it does not affect the resource level.

Send multi-value parameters

You might want to send the same query parameter with several different values in the same request, like this:

http://example.com/resource?param=value1&param=value2

Or, you might want to do the same with a header, for example:

GET http://localhost:8084/pages HTTP/1.1

Accept-Encoding: gzip,deflate
X-Custom-Header: value1
X-Custom-Header: value2

To do this in ReadyAPI:

Request parameters: Specify parameter values

Click the image to enlarge it.

  1. In the request properties, specify the multi-value delimiter that you will use to separate values. Press Enter to confirm the changes.

  2. Specify the values of the parameter. Separate them with the delimiter specified in the previous step.

See Also

REST Parameter Types
REST Requests

Watch the video
 
Highlight search results