A T B API Test Base

Quick Start

    Install and Launch

    • Download API Test Base 0.36.2 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.2 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.2 --net=host apitestbase/apitestbase:0.36.2

      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.2 --net=host apitestbase/apitestbase:0.36.2

      If not using host networking

      // Windows or macOS host
docker run -d -t -v /data/folder/on/host:/atb/data --name apitestbase-0.36.2 -p 8090:8090 apitestbase/apitestbase:0.36.2

// Linux host
docker run -d -t -v /data/folder/on/host:/atb/data --add-host=host.docker.internal:host-gateway --name apitestbase-0.36.2 -p 8090:8090 apitestbase/apitestbase:0.36.2

      Once the container is running, open http://localhost:8090/ui in a Chrome browser on the host machine.

    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.