Utilities API

Introduction

We provide an API endpoint called Utilities where you can send API requests during your tests in order to process data.

It's easier to use the standard Utilities, which is an option available in the Miscellaneous action, instead of the Utilities API.

Steps

1. Add a Send API Request step in your test.
2. Select the GET option from the list of request types.
3. Add the following URL in the Enter request URL input: https://app.endtest.io/utilities
4. In the Params section, add the action that you need together with the rest of Quary Params.
5. The action and the rest of the Query Params need to be added in the standard key-value format.
6. You can also add Endtest variables in the Params section, simply typing $ in one of the inputs will show you a dropdown with all the available Endtest variables.
7. You can choose to save the response of that API request into a new Endtest variable.
8. Go to the Response section, in the Body subsection.
9. Choose the Store in variable option from the Action dropdown from the the Body subsection.
10. Add the name of the variable that will contain the body of the response.

Actions

You can choose from different actions:

1. Extract Text After Pattern

The extractTextAfterPattern action can be used to extract a substring from a string, by providing another substring as a pattern.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	extractTextAfterPattern
text	the full text or the name of the variable
pattern	the pattern of text or the name of the variable

For example, let's say you have the following text:

Your validation code is 1234

You can extract the 1234 portion of that text by providing the following pattern:

Your validation code is

That will extract the following substring:

1234

2. Extract Text Before Pattern

The extractTextBeforePattern action can be used to extract a substring from a string, by providing another substring as a pattern.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	extractTextBeforePattern
text	the full text or the name of the variable
pattern	the pattern of text or the name of the variable

For example, let's say you have the following text:

1234 is your validation code

You can extract the 1234 portion of that text by providing the following pattern:

is your validation code

That will extract the following substring:

1234

3. Extract Numbers From Text

The extractNumbersFromText action can used to extract all the numbers from a string.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	extractNumbersFromText
text	the full text or the name of the variable

For example, let's say you have the following text:

Your validation code is 1234. Do not share it with anyone else.

You can extract the 1234 portion of that text because it's entirely made up of numbers.

4. Extract Value From JSON

The extractValueFromJSON action can used to get a value from a JSON object.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	extractValueFromJSON
json	the JSON object
name	the name for which you will get the value

For example, if you have the following JSON object:

{"firstName":"John", "lastName":"Doe"}

This is how the Send API Request modal would look like if you want to extract the firstName value:

Don't forget, you can also use Endtest variables in the Send API Request modal.

5. Extract Item From Array

The extractItemFromArray action can used to get an item from an array.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	extractItemFromArray
array	the array from which you will extract the items
index	the location of the item from the array (the first array index is 0)

For example, if you have the following array:

["apple", "orange", "tomato"]

This is how the Send API Request modal would look like if you want to extract the second item:

Since you can use Endtest variables in the Params, Authorization and Headers sections and you can also store the responses in Endtest variables, you can chain together multiple Send API Request steps which can use the extractItemFromArray and extractValueFromJSON actions to extract values from complex JSON objects.

In each Send API Requeststep, go to the Body section from the Response tab and select the option to store the value inside an Endtest variable, which will be used in the next step.

For example, you might have a complex JSON object like this:

{
"employees":[
    {"firstName":"John", "lastName":"Doe"},
    {"firstName":"Anna", "lastName":"Smith"},
    {"firstName":"Peter", "lastName":"Jones"}
]
}

If you want to extract the second firstName value from that JSON object, you have to chain together 3 Send API Request steps:

Start by using the extractValueFromJSON action to get the value for the employees item:

[
    {"firstName":"John", "lastName":"Doe"},
    {"firstName":"Anna", "lastName":"Smith"},
    {"firstName":"Peter", "lastName":"Jones"}
]

That value will be an array and you can use the extractItemFromArray to get the second item from that array.

{"firstName":"Anna", "lastName":"Smith"}

That item will be a JSON object and you can once again use the extractValueFromJSON action to get the value for the firstName.

6. Extract Last Item From Array

The extractLastItemFromArray action can used to get the last item from an array.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	extractLastItemFromArray
array	the array from which you will extract the item

For example, if you have the following array:

["apple", "orange", "tomato"]

This is how the Send API Request modal would look like if you want to extract the last item:

7. Get Text Length

The getTextLength action can used to get the character count of a text.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	getTextLength
text	the full text or the name of the variable

8. Store Item in Vault

In some scenarios, you might need to manage values across different test suites.

These use cases can usually be handled by using Variables and Import Test Case actions.

But there are other scenarios where one test suite might update a value which is used by other test suites.

You can use the Endtest Vault to store and fetch global values, which can be accessed from all your test suites.

These global values are called items.

The storeItemInVault action can be used to store an item.

The items stored in the Endtest Vault can only be accessed by you and your Team.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	storeItemInVault
itemName	the name of the item
itemValue	the value of the item
appId	the appId for your account
appCode	the appCode for your account

This is how the Send API Request modal would look like:

You can also use Variables:

After clicking on the Send button, you will see the 'done' message in the Body subsection of the Response section if the request was successful:

9. Get Item from Vault

The getItemFromVault action can be used to fetch global values stored in the Endtest Vault.

These global values are called items.

The items stored in the Endtest Vault can only be accessed by you and your Team.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	getItemFromVault
itemName	the name of the item
appId	the appId for your account
appCode	the appCode for your account

This is how the Send API Request modal would look like:

After clicking on the Send button, you will see the value of the item in the Body subsection of the Response section if the request was successful:

That value can be stored in an Endtest variable and used in your test suite:

10. Generate Random Name

The generateRandomName action can be used to generate random names.

Key	Value
action	generateRandomName
type	first, last or full
gender	female or male

This is how the Send API Request modal would look like:

After clicking on the Send button, you will see the value of the name in the Body subsection of the Response section if the request was successful:

That value can be stored in an Endtest variable and used in your test suite:

11. Extract Character from String

The extractCharacterFromString action can be used to extract a certain character from a string.

Key	Value
action	extractCharacterFromString
string	the full text or the name of the variable
index	the location of the character from the string (the first index is 0)

This is how the Send API Request modal would look like:

After clicking on the Send button, you will see the character in the Body subsection of the Response section if the request was successful:

That value can be stored in an Endtest variable and used in your test suite:

12. Convert Text to LowerCase

The toLowerCase action can be used to convert a text to LowerCase.

Key	Value
action	toLowerCase
text	the full text or the name of the variable

This is how the Send API Request modal would look like:

After clicking on the Send button, you will see the converted text in the Body subsection of the Response section if the request was successful:

That converted text can be stored in an Endtest variable and used in your test suite:

13. Convert Text to UpperCase

The toUpperCase action can be used to convert a text to UpperCase.

Key	Value
action	toUpperCase
text	the full text or the name of the variable

This is how the Send API Request modal would look like:

After clicking on the Send button, you will see the converted text in the Body subsection of the Response section if the request was successful:

That converted text can be stored in an Endtest variable and used in your test suite:

14. Send Email

The sendEmail action can be used to send an email from any endtest-mail.io address.

This feature is not available during the free trial.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	sendEmail
from	Email address of sender
to	Email address of recipient
subject	The subject of the email
body	The body of the email
attachment	The File Download Link from the Endtest Drive (optional)
appId	the appId for your account
appCode	the appCode for your account

15. Math Calculations

The math action can be used to perform mathematical operations.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	math
operation	the arithmetical operation
items	a list of numbers, separated by ;

Supported operations: addition, subtraction, multiplication, division.

You can perform math operations with variables by placing the variable name between double curly brackets:

{{$price}};{{$tax}}

16. Remove Newline Characters

The removeNewLines action can be used to remove Newline characters.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	removeNewLines
text	the text from which the Newline characters will be removed

17. Extract Random Item From List

The extractRandomItemFromList action can used to get a random item from a list.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	extractRandomItemFromList
list	the list from which you will extract the item

For example, if you have the following array:

orange; apple; tomato

This is how the Send API Request modal would look like if you want to extract the last item:

18. Extract Value From XML

The extractValueFromXML action can used to get a value from an XML object.

Query Params that you need to add in the Send API Request modal:

Key	Value
action	extractValueFromXML
xml	the XML object
name	the name for which you will get the value

For example, if you have the following XML object:

<Response>
<CountryCode>US</CountryCode>
<CountryName>United States</CountryName>
<RegionCode>CA</RegionCode>
<RegionName>California</RegionName>
<City>Mountain View</City>
<ZipCode>94043</ZipCode>
<Latitude>37.4192</Latitude>
<Longitude>-122.0574</Longitude>
<MetroCode>807</MetroCode>
<AreaCode>650</AreaCode>
</Response>

This is how the Send API Request modal would look like if you want to extract the City value:

Don't forget, you can also use Endtest variables in the Send API Request modal.