API Fortress

The API Fortress plugin allows you to add an API testing build step in your Jenkins CI. There are multiple testing modes you can choose from, depending on your needs.

The key parameter that you need to retrieve from API Fortress for any mode is the Webhook URL, a uniquely generated URL representing a project. You can create them in the company settings of your API Fortress account.

 

Modes

There are 4 testing modes available. "Run single test" will run a single test, while the others will run suites of tests.

Run single test

You can run a single test by providing a test ID. Test IDs can be found in test interstitial pages.

Run automatch

You can run our "automatch" mode by providing a URL representing a certain endpoint. You can configure automatch patterns in the "Automatch" section of each test. Read more about automatch Here .

Run by tag

By running "by tag" you can run multiple tests, marked with a certain tag. Tags can be added and edited in the test details.

Run project

By running a full project, you'll be running all tests contained in the project.

Options

The following options can apply to any mode.

Blocking

The plugin can silently run (blocking = false), let the build continue with a success and inform you if the test failed using the various methods available. Or it can be actively determining the build success (blocking=true) so that the build will wait for the tests result and stop the build if the tests fail.

Dry-run

If checked no events will be stored within API Fortress. To be used in conjunction with "blocking".

Silent

If checked no alerts will be sent if the tests fail.

Parameters override

You can override up to 3 parameters in the test scope. These variables will appear within the test scope just like any other variable. Pretty useful if you're willing to override the domain of the service being tested (Ie. staging vs production).

 

Changelog

Version 1.0 (Jul 12, 2017)

  • Initial release