REST Definition Editor¶
Purpose¶
The REST Definition Editor allows you to edit REST web service definition files (.rest
).
How to Open¶
Use the Add Web Service Dialog to create a new REST definition (.rest
) file. The definition file then opens in a REST Editor within the Content View.
Alternatively, you can double-click an existing .rest
file in the Test Files View explorer window. The definition file then opens in a REST Editor within the Content View. The REST Toolbar also becomes visible at the top of the editor.
Request¶
The request form has several sections to populate:
- Method - The type of HTTP request (GET, POST, PUT, DELETE, etc.).
- URL - The URL of the web service request, with any included parameter tokens (e.g., {session_id} in the example above).
- Credentials - Any HTTP Basic Authentication headers.
- Headers - Any other HTTP headers (both standard and custom).
- Parameters - Any parameters defined in the URL that are called from the Rapise test script.
- Body - The body of the request (for POST and PUT requests). This can be in any text-serialized format such as XML or JSON.
Response¶
The HTTP Response Headers are displayed:
The HTTP Response in XML format is formatted and displayed:
The HTTP Response in JSON format is formatted and displayed:
This displays the output from the last web service request. It has several tabs:
- Response Header - Displays a list of the HTTP response headers (name and value). If the request received a
200 OK
code, it is displayed in green; if it receives an error code, it is displayed in red. - Response Body
- Raw - Displays the raw text of the HTTP response body received from the server.
- XML - If the received body content is identified as XML, this tab displays well-formatted XML that is easier to read than the raw response body.
- JSON - If the received body content is identified as JSON, this tab displays well-formatted, indented JSON that is easier to read than the raw response body.
Operation Explorer¶
This section allows you to add, open, delete, and clone REST requests within the definition file.
-
Add request
- Adds a new REST operation to the current.rest
definition file. -
Clone request
- Creates a copy of the currently selected REST operation and allows you to give the copy a new name. -
Delete request
- Deletes the currently selected REST operation from the current REST definition file.
Script Steps¶
The REST Script Steps tab in the bottom view allows you to view the list of recorded REST operations and use them to create your test script in the main test file.
-
Create Script
- Takes all recorded steps and automatically creates the matching JavaScript code in your test script. -
Remove Step
- Removes the recorded step from the script box. -
Clear
- Removes all recorded steps from the script box.
Each step displayed in the script box contains the name of the REST operation and its HTTP method (GET, POST, PUT, DELETE, etc.). Steps displayed in bold* and marked with an asterisk also have a verification point recorded. This means that when the script is generated, it includes a
Tester.Assert
function to verify the results.
See Also¶
- For more information on REST Web Services, see REST Web Services.
- For a tutorial on creating a REST web service test, see the Web Services REST Tutorial.