Assertion

Assertions play a crucial role in API testing. When you need to verify if the response of an request meets your expectations, you have to write an assertion. In tools like Postman, assertions require writing scripts manually. Nevertheless, in Apidog, you can visually create assertions, which is extremely convenient.

Adding an assertion to post processor

In the Run tab (Design-first Mode) or the Request tab (Request-first mode), navigate to Post Processors.

Design-first Mode

Request-first Mode

Hover over "Add Post Processor" and select "Assertion".

Select the target for your assertion, which can be various elements in the API response such as headers, body content, or status codes. You can choose the specific element that you want to verify against your expected outcome. (For example:$.data.status) Please note that the root object is represented by$, and it works for both objects and arrays.

If the target is in the JSON body, use JSONPath to extract the desired value.

Set the assertion conditions based on your testing requirements. You can define criteria such as equal to, not equal to, contains, does not contain, greater than, less than, etc.
In the assertion value field, you can input a static value or use dynamic variables in the format of {{variable}}.

Click on the send button to execute the assertions. You can view the results of the assertions in the right-hand side panel.

When performing assertions in Apidog, all data is automatically converted to STRING for comparison. While this simplifies the process in most cases, you may encounter bad cases such as 4 not being equal to 4.0. For such specific assertions where data comparison needs to consider more intricate details, you can utilize custom scripts to write assertions manually.

Setting assersions on actual response

To quickly create an assertion based on the actual response, hover over the response field(e.g., on endpoint response or test reports), and click onassertion.

Using scripts for assertions

In Apidog, you can employ the pm.test syntax to create assertions using scripts. Apidog is compatible with Postman scripts, allowing users to leverage existing scripts seamlessly.

Learn more about scripts.

Adding an assertion to post processor#

Setting assersions on actual response#

Using scripts for assertions#

Adding an assertion to post processor

Setting assersions on actual response

Using scripts for assertions