A test scenario in Apidog testing serves as the fundamental unit, analogous to a Collection in Postman. When you need to send multiple requests consecutively, build continuous test scenarios, or repeat requests with different test data, you can create a test scenario and add the necessary requests to it.Benefits of Test Scenarios#
Using test scenarios in Apidog, you can efficiently meet a range of API testing requirements:| Feature | Description |
|---|
| Sequential Request Execution | Organize and execute multiple requests in a specified order to simulate user interactions or process flows |
| Test Reporting | Automatically generate reports that provide detailed visualizations of assertions and individual request outcomes |
| CI/CD Integration | Integrate test scenarios into CI/CD pipelines to ensure automatic testing during development cycles, facilitating early detection of issues |
| Performance Testing | Evaluate API performance under varying loads and generate trend analyses to identify changes in response behaviors over time |
| Dynamic Parameter Testing | Execute requests multiple times using dynamically generated parameters to test how the API handles variable inputs |
| Predefined Test Data | Utilize preset data for requests to simulate realistic operation conditions and verify API responses against expected outputs |
| Data Passing Between Requests | Automatically pass data from the output of one request to another, crucial for testing APIs requiring state persistence across calls |
| Logical Request Relationships | Configure logical conditions such as if, for, and foreach to manage the execution flow based on the outcomes of prior requests or specific conditions |
These features allow you to create versatile and effective test environments that contribute to robust and high-quality API development.Creating a Test Scenario#
Upon opening Apidog, navigate to "Tests" module, and then click the + next to the search bar to create a new test scenario. Select the appropriate directory for it, and set the priority to complete the creation.Adding Test Steps#
Once you have set up your test scenario in Apidog, you can start populating it with requests. There are several ways to add requests, each tailored to different needs and flexibility:Requests Linked to the Endpoint Spec#
These requests could be updated as the endpoint specification changes:Import from Endpoint Spec#
You can import endpoint specs from the current project as steps in the test scenario. There are two modes when importing endpoints: "Manual" and "Automated." For more detailed instructions, please refer to Sync data from endpoints/endpoint cases.In "Manual" mode, modifications to the endpoint documentation within the project do not have an immediate impact on the endpoints in the test steps. Synchronization of test data only occurs when testers activate the "Manual" button. It is important to note that alterations made to the test step data will not update the endpoint documentation, even when clicking for "Manual Sync". Instead, clicking this button enables the test scenarios to retrieve information from the endpoint documentation for synchronization purposes.In the "Automated" mode, any changes in the endpoint documentation within the project will be updated synchronously in the test steps.Import from Endpoint Case#
You can choose to import endpoint cases from the current project or other projects. There are two modes when importing endpoint cases: "Copy" and "Reference".When importing an endpoint case as "Copy", the parameters in the endpoint case will also be copied into the test steps. They will be independent of each other, and changes in each will not affect the others. Manual sync can be selected.When importing an endpoint case as "Reference", it will directly use the endpoint case from the original project for the request.If the test step is referenced from a case, you'll see a prompt indicating that modifying this step will also affect the original endpoint case and any other steps that use it.Independent Requests Not Associated with the API Spec#
These requests do not update in response to changes in the API spec. They allow for greater customization:Add Custom Request#
In a working process, you may need to call an endpoint outside of the project, such as a third-party payment endpoint.You can add a custom API request in the test steps. The custom request can be any HTTP request, including common GET, POST, PUT, DELETE, etc.Add from cURL#
In a real working processes, many endpoint requests are presented in the form of cURL command lines. You have the option of importing cURL requests into the test steps, with just a single click.Reference Other Test Scenarios#
Include Steps from Other Test Scenarios#
You can clone the test steps or process control conditions by importing from other test scenarios within the same project.Reference Other Test Scenarios#
You can reference other test scenarios as a test step. There are two use cases:1.
If your business process has some common, reusable API test steps, you can compile these steps into a small test scenario and then reference it directly in other wider test scenarios.
2.
If you need to regress the mainstream process of the entire product, you can refer to the various sub-test scenarios in the test scenario for assembly, and complete the test regression work of all mainstream processes with one click.
To prevent infinite loops and situations where the test scenario cannot stop running normally, the feature of referencing other test scenarios cannot reference the original test scenario itself.
Orchestrating the Test Scenario#
Clicking any test step will enter the orchestrate mode. In this mode, you have a larger operating page to better and more efficiently fill in the detailed content of each test step. The left side of the page is the overall flow of the test scenario, and the right side is the details of the selected test step. Endpoint requests and testing process control components will have different display panels.You can adjust the order of the steps by dragging the β‘ in front of the step.You can use the "β¬οΈ" and "β¬οΈ" keys to quickly switch between the selected test steps in this mode.In the orchestrate mode, you can edit multiple steps and then click the "Save All" button in the top left corner to save all the changes.If any step has unsaved changes, the step will be marked with a dot in the list bar on the left. Remember to always save the changes you have made. 
