I/O Operations

The I/O operations you can do are: GET, POST, PUT, PATCH and DELETE.

From the composer, choose ‘Add Component’ and then choose the type of operation you want to do.

Once done, you will have a form to fill up:

Parameters:

Name Type/Value Required
Url Url Yes
Variable String Yes
Expect String No
Mode ‘json’,’xml’, ‘html’,’text’ Yes
Params String No

Url: the url of the resource you want to test. It could be the full url of the resource or a string with variables using the $. (i.e. ‘https://domain/resourcename’ or ‘https://${domain}${endpoint}’)

Variable: the name of the variable that contains the response. It will be the name you will refer during the test.

Expect: it is an optional field and needs to be filled only if the expected behavior differs from a positive response (Ie. 404,500 vs. 200,201 etc.).
Possible values are ‘<statusCode>|VALID’ or ‘<statusCode>|INVALID‘.
VALID means the payload type is the one selected in the “mode” field (JSON,XML), while INVALID means the opposite.
Some examples:

  • 404|VALID : 404 is expected with valid payload
  • 422|VALID : 422 is expected with valid payload
  • 500|INVALID : 500 is expected with invalid payload

Multiple status codes can be expected by adding them all, separated by a pipe character (i.e. 200|302|400|VALID)

Mode: it’s the type of the response you want to test.

Params: the optional list of params you want to add to the query string. To do so, tap on ‘Add parameter’. The params can either be a String value (in that case, the value will always be the same for all the requests; to do so, just put the value in the related field and choose ‘String value’ from the drop down menu) or a Variable (in that case the value will be taken dynamically and could changed from time to time; to do so, put the name of the variable inside the field and choose ‘Variable’ from the drop down menu).

Using the above example: let’s say that varName is defined as a boolean value so it can be either ‘true’ or ‘false’, in that case, there will be two requests; the first one will be a GET request to ‘https://mydomain/endpoint?firstParam=paramValue&secondParam=true’, parsing it as ‘json’ and saving it in the ‘payload’ variable; the second one, will be a GET request to ‘https://mydomain/endpoint?firstParam=paramValue&secondParam=false’, parsing it as ‘json’ and saving it in the ‘payload’ variable.

When all things are set up, you can confirm it by tapping on the ‘tick’ icon in the top right corner. After that, if you need to add headers, params or a body to the request you can do it by selecting the request and then tapping on the ‘Add component’: all the available components for each operation will be active.

Config

Name Type/Value Required
Name String Yes
Value String or Variable Yes

Header

Name Type/Value Required
Name String Yes
Value String or Variable Yes

Post Param/Put Param/Patch Param

Name Type/Value Required
Name String Yes
Value String or Variable Yes

Post Body/Put Body/Patch Body

Name Type/Value Required
Content-Type ‘application/json’, ‘text/plain’, ‘application/x-www-form-urlencoded’,’text/xml’ Yes
Content String No