Applies to ReadyAPI 2.5, last modified on October 22, 2018

About REST Request test step

The REST Request test step sends a REST request of the specified type (GET, POST, PUT and so on), gets a response and validates it with assertions. You can adjust the test step parameters, authorization settings, and so on.

To use the REST Request test step, you need to add a REST service to your project.

Editing REST Request test step

Each REST request test step is based on a REST request defined in your API. ReadyAPI takes the method, resource and parameters specified for this request. To change these data, you need to link your test step to another REST request. To change the endpoint and parameter values, you can use the test step editor, which is similar to the editor you use to modify requests (see Request Panels). The changes you make to your test step do not affect the base request.

Test step editor overview

Click the image to enlarge it.

Here is a brief description of available panels in the request editor:

Request Displays request parameter information in a table. You can see the parameter’s name, value and type.
You can use the project, test suite or other properties to specify parameter values. For information on request parameter types (QUERY, TEMPLATE, HEADER, and others) and how to specify them in the editor, see REST Parameters.
Raw Displays the header and body of the request in a text format.
ReadyAPI populates this tab after you run the test step.
Outline Displays the request body as a tree. Works for POST and PUT requests only. You can change elements’ and attributes’ values in-place. Just double-click the cell with the needed value.
Form Lets you specify parameter values by using various edit controls.
Auth Use this panel to specify the authorization type (Basic, NTLM or SPNEGO/Kerberos) and authorization parameters for your request.
Headers Use this panel to create and modify custom header fields. See also Adding Headers and Attachments.
Attachments Allows you to specify the files to be attached to the request. See also Adding Headers and Attachments.
Representations Displays request representations for the request data. ReadyAPI loads representation information from the web service WADL.
JMS Headers Displays the Java Message Service headers and properties. This inspector is available if you specified a JMS endpoint for the request.

Once you run the test step, the server response is available in the response editor.

Property list

Besides editors and inspectors, you can adjust the test step’s behavior by using its properties in the REST Request Properties and Custom Properties tabs.

Name Description
Name

The test step’s name.

Description

Text description of the test step.

Message Size

Shows the size of the response in bytes.

Encoding

The encoding of the request data in the charset header. You can select one of the predefined values or specify a custom value. If it is empty, the utf-8 encoding is used.

Endpoint

A URL address of the tested web service.

Service

The tested service name.

Resource

The tested resource to which the test step is sent.

Method

The tested method.

Timeout

The number of milliseconds to wait for a server response. If there is no response during this period, the test step fails. The 0 or absent value means an infinite wait time.

Bind Address

The network interface (IP address), through which ReadyAPI will send the request.

Follow Redirects

Enables handling of redirects. Specify true to allow the request to be sent to a new address. When it is set to false, the request receives the actual response from the server without going to a new address.

Use GET Method on 302 Redirect

If set to true, when a server redirects the request with the 302 status code, ReadyAPI sends the GET method.

Works only when the Follow Redirects property is set to true.
SSL Keystore

The file that stores the private keys used to authorize ReadyAPI when connecting to the server. This works for HTTPS requests only.

Strip whitespaces

Removes comments and extra whitespaces from elements and attributes. Required by some servers. Works for request contents in the XML format.

Remove Empty Content

Remove empty elements from the request. Works for request contents in the XML format.

Entitize Properties

Specifies if special characters should be encoded. HTML symbols (like & or >) are entitized into (& or >). Set to false if data is already encoded.

Disable Property Expansions

When it is set to true, ReadyAPI does not evaluate property expressions and insert them as they are specified in the request editor.

Multi-Value Delimiter

Sets a delimiter used to separate QUERY parameter values.
For example, if you set the parameter name as sample, its value - as test1,test2 and the delimiter - as ,(comma), the query will be ?sample=test1&sample=test2.

Pretty Print

When this option is set to true, the XML panel of the response displays data with line breaks and indents.

Dump file

Specifies the fully qualified name to the file, to which you want to save the server’s response. Leave this property empty not to save the response to a file.

Max size

Specifies the maximum number of response bytes that ReadyAPI shows in the editor to save memory. To show the entire response, specify 0.

Specified assertions may fail, because there will not be enough data for verifying.
Discard Response

When this option in set to true, ReadyAPI deletes the response data from the memory after the assertion runs. Works only if the test step editor is closed.

This tab contains:

  • Properties that correspond to the request parameters.

  • Properties that provide access to the request and response data.

Notes:

  • You can load values of custom properties from a file, or save them to a file. To learn more, see About Properties.

  • Values on the Custom Properties tab are available to other test steps in your project. For instance, you can verify these property values with the Assertion test step, or check them and change the execution flow with the Conditional GoTo test step.

Name Description
Response

The response data without headers. You can see the same content in the response XML panel. To get response data without headers, use the RawResponse property.

RawRequest

The body content of the sent request. You can see the same content in the request Raw panel. Property expansions are converted to the expected values. To get the data with unconverted property expansions, use the Request property.

Endpoint

Duplicates the Endpoint property of the REST Request Property tab. Used to get its value by using the property expansion.

Username

Duplicates the Username property of the REST Request Property tab. Used to get its value by using the property expansion.

Request

The request body without headers. Property expansions are represented as they are without conversion to expected values. To get the sent request with converted property expansions, use the RawRequest property.

HarResponse

The response in the .har format.

Domain

Duplicates the Domain property of the REST Request Property tab. Used to get its value by using the property expansion.

ResponseAsXML

Response data as an XML DOM document (if possible).

Password

Duplicates the Password property of the SOAP Request Property tab. Used to get its value by using the property expansion.

RawResponse

Response data with headers. You can see the same content in the Raw panel of the response editor. To get response data without headers, use the Response property.

Test step toolbar

The test step toolbar contains commands that allow you to modify a test step, change the base REST request or customize appearance of the test step editor.

REST Request test step toolbar

Click the image to enlarge it.

Verifying response

To add, change, or modify the assertions, use the Assertion panel. You can use the following assertions:

Name Description
Property Content:
Contains Verifies that the response contains the specified string.
Equals Verifies that the value of a property is equal to the specified value.
Equals (Binary) Checks whether the binary response is equal to a file.
JsonPath Count Counts the occurrences of the specified element.
JsonPath Existence Match Checks whether the specified element exists.
JsonPath Match Checks whether the specified element matches an expected value.
JsonPath RegEx Match Checks whether the specified element matches a regular expression.
Message Content Assertion Verifies that the message contains expected contents.
Not Contains Verifies that a response does not contain the specified value.
XPath Match Checks whether the result of the specified XPath expression is equal to the specified value.
XQuery Match Verifies that a result of the specified XQuery expression is equal to the specified value.
Compliance, Status and Standards
HTTP Header Equals Checks whether the response contains the expected value of an HTTP header.
HTTP Header Exists Verifies that the response contains the specified HTTP header.
Invalid HTTP Status Codes Checks whether the HTTP status code is not on the specified list.
JSON Schema Compliance Verifies that a request and response are compliant with the specified JSON schema.
Schema Compliance Checks whether the response is compliant with the inferred schema.
The REST Request does not support specifying a schema from a service definition.
Swagger Compliance Assertion Verifies that a request and response are compliant with an OpenAPI or Swagger specification.
Valid HTTP Status Codes Checks whether the HTTP status code is on the specified list.
Script
Script Assertion Executes a script to perform a custom assertion.
SLA
Response SLA Checks whether the response was returned within the specified timeout.
JMS Response
JMS Status Verifies that the JMS request is successful.
JMS Timeout Checks whether a JMS response returns within a specific time period.
Security
Sensitive Information Exposure Verifies that the response does not contain any valuable information.

Logging

While the test step editor is open, brief information on sent requests is listed in the Request Log tab. If the test step is run as part of a test case, you can see a more detailed log in the Transaction Log panel.

Working with

Below, you can find information on common tasks that you can perform with the REST Request test step.

Specify a new endpoint in the test step toolbar. By using a drop-down list, you can select one of the endpoints specified on the Endpoint page of the service editor. The following commands of the list allow you to modify the endpoint list:

  • edit current – changes the selected endpoint.

  • add new endpoint – adds a new endpoint to the list.

  • delete current – removes the selected endpoint from the list.

Another way to modify the endpoint is using the Endpoint property.

You can modify request parameter values in the Request panel. These changes will not affect the default values. To restore default values specified in REST Request, click .

To change the parameter name or type, you need to modify the REST request to which this test step refers:

  1. Switch to the Projects tool.

  2. Find the request in navigator and double-click it.

  3. Select the desired property and modify it according to your needs.

To load the content of any parameter from a file:

  • Add the file to the Attachments panel in the request editor.

  • Get the data by using the property expansion with the following syntax:file:myFileName.log:

    REST service testing: Loading parameter values from a file

To specify values in text boxes and cells in the test step editor, you can use the project, test suite, and other property types. To refer to a property, use the following syntax:

  • ${#Project#MyPropertyName} – Project properties.

  • ${#TestSuite#MyPropertyName} – Test suite properties.

  • ${#Env#MyPropertyName} – Environment properties.

For more information, see Property Expansion.

To add a custom header:

  1. Open the Headers panel of the request editor.

  2. Click and specify the desired header and its value.

To remove the Content-Length: 0 header from your request, add the -Dsoapui.send.zero.content.length=false parameter to the vmoptions file located in the <ReadyAPI>/bin directory and restart ReadyAPI.

To add authorization:

  1. Open the Auth panel of the request editor.

  2. Select the desired Authorization profile.

To learn more about authorization, see Authorization.

To verify that the server returns the expected response, use assertions:

  1. Click Add Assertion on the request editor toolbar.

  2. In the Add Assertion dialog, specify the desired assertion.

  3. Set up a new assertion according to your needs and click OK.

See Also

Test Steps
SOAP Request Test Step
HTTP Request Test Step

Highlight search results