Test Case Fields
This specifies the test case id. This field value is automatically generated and can be edited. This id field will help you in finding the test case file quickly on the file system.
This specifies the template reference to be re-used in this testcase. Once you specify the
$ref property in the test case file then it inherits all the other properties from the template. For more information, read Templates.
This field specifies the field names which you would like to override from its associated template. When you convert a test case into a template then
Summary field is automatically overriden. For more information, read Templates.
This specifies the request method of the test case. The possible values as of now are GET, POST, PUT, PATCH, DELETE. If you are using any other request method then let us know. We will support the additional request methods on the basis of user's request.
This specifies the request URL or API endpoint of the test case. You may use any global or extracted variables in this field e.g. baseURL. If you specify the URL with query parameters here then query parameters will be extracted and will be imported in the Query parameters field.
This specifies the test case summary. Providing a meaningful summary will help you or your team knowing about what the test case is doing.
This specifies the test case description. Here in this field, you may provide the detailed information about the test case. This field is only for informational purposes for you.
If you are maintaining this test case in external test case management tools then provide the test case id of the external test case management tool here. This field value will be available in the hooks. With the help of this value, you may update status in any external test case management tools like TestRail.
This specifies the test case condition on which you want to execute the test case.
If you would like to execute the test case with-in a loop then provide the loop source value here. This field is important when you want to read the data read from excel sheet for data driven testing.
Wait for Seconds
If you want to hold the execution of a test case for some time, then this field is important for you. In this field value, provide the number of seconds for which you want to hold the test case execution.
This specifies the authorization configuration used for this test case. To configure the authorization, please visit
Configuration tab >>
Authorizations section. For more information on this, please visit our document on Authorization.
This specifies the tags to link with test case. This is useful to associate any tags with the test case. Later on, you may apply filter on tags in the Left Navigation Pane to view the assciated testcases with the tag.
This specifies the local hooks here to link with test case. These hooks will be validated along with test case assertions. For more information, please read Hook Types.
Request Query Parameters
You may specify the request query parameters in the
Query tab. If you have a URL with query parameters then provide this URL in the URL field then query parameters will be automatically extracted by vREST.
Body tab, you may specify the Request body. vREST supports the form data, JSON, XML and Text Body. If you are looking for Multipart support then please contact us.
Headers tab, you may specify the request headers tab.
Validation via Assertions
Assertions tab, you may specify the assertions to validate the API response. vREST supports assertions on Status Code, Response Headers, Response Time, and Response Body. For more information, please read our guide on Basic Response Validation and Advanced Response Validation.
Validation via Expected Body
Expected Body tab, you may specify the expected body for your API response. When you enable the expected body tab, then it automatically enables the Text Body assertion which calls the Default Validator or any other custom response validator.
Validation via Expected Schema
Expected Schema tab, you may specify the expected JSON schema for your API response. When you enable the expected schema tab, then it automatically enables the Text Body assertion which calls the Default Schema Validator. vREST supports JSON schema draft3, draft4, draft6 and draft7. For more information, please visit our guide on Schema Validation.
Variable Extractor tab, you may extract the information from the API response and store them into variables for use in subsequent requests. In this way, you may chain multiple requests.
Template Data tab, you may specify the values of the template variables if the test case is linked with any template. For more information, read Templates.