Quick Start

Install and Launch

Download API Test Base 0.36.4 from the release page.

When running the setup or portable binary, you will likely get a warning dialog from Microsoft Defender SmartScreen, because the app hasn’t been digitally signed by a Microsoft trusted Certificate Authority (which is expensive!). Click More info on the dialog, and click Run anyway to proceed.

First time launching, a Windows Defender Firewall alert will pop up. Check the Private networks ... option, uncheck the Public networks ... option, and click the Allow access button.
Download API Test Base 0.36.4 from the release page.

Double click the dmg and drag API Test Base.app to your /Applications folder.
If you are using Docker Engine (Linux only) or Docker Desktop version 4.34 or later, the recommended way to launch API Test Base is with host networking.
```
docker run -d -t -v /data/folder/on/host:/atb/data --name apitestbase-0.36.4 --net=host apitestbase/apitestbase:0.36.4
```
Notice: Replace /data/folder/on/host with your own value, so that your data can be retained on the host machine when the container is deleted. For example (Windows host):
```
docker run -d -t -v C:\Users\zheng\AppData\Roaming\ApiTestBaseDocker:/atb/data --name apitestbase-0.36.4 --net=host apitestbase/apitestbase:0.36.4
```
If not using host networking
```
// Windows or macOS host
docker run -d -t -v /data/folder/on/host:/atb/data --name apitestbase-0.36.4 -p 8090:8090 apitestbase/apitestbase:0.36.4

// Linux host
docker run -d -t -v /data/folder/on/host:/atb/data --add-host=host.docker.internal:host-gateway --name apitestbase-0.36.4 -p 8090:8090 apitestbase/apitestbase:0.36.4
```
Once the container is running, open http://localhost:8090/ui in a Chrome browser on the host machine.

If you use the docker container in CI/CD pipeline, call ATB’s own API (with HTTP command line tool like curl) for API test automation. Open http://localhost:8090/apidoc on host machine for checking the Swagger UI.
Download apitestbase-0.36.4-allos-nojre.zip from the release page.

This build is for running ATB on any OS where Java 21+ has been installed. To run the ATB, extract the downloaded zip, and run the start.bat (on Windows) or start.sh (on macOS or Linux).

It is typically used in CI/CD pipeline where you call ATB’s own API (with HTTP command line tool like curl) for API test automation. Open http://localhost:8090/apidoc for checking the Swagger UI.

You can also use it (on page http://localhost:8090/ui) for requests or test cases creation, but it opens a terminal window which might not be the best UX.

Ad Hoc Invocation

Suppose you want to invoke a REST API.

Right click anywhere on the left side pane, select New Request > HTTP, give it a name and press Enter. The request is created.

In the request edit view, under the Invocation tab, enter a URL like http://localhost:8090/api/articles (an API Test Base bundled API) and click the Invoke button.

Ad Hoc HTTP Invocation

The request, as well as all the data you create in API Test Base, is automatically persisted on your local machine. No Save button.

Docker users: if not using host networking, to enable ATB docker container to call your API on the host machine, use host.docker.internal as hostname in the request URL.

NEXTCreating Automated Test Case