Tools API
Introduction
Deepcrawl Automate Tools is a helper REST API that CI scripts are using to start and poll Lumar Protect builds. You can use this API along with Graph API to write your own scripts.
URL: https://tools.automator.deepcrawl.com
Trigger Build
POST /start
This enpoint triggers a new build run. If there is a build already running, it will abort it and run a new one.
Available params:
authToken
- Token for Graph API. You can find instruction for how to generate this token here.
testSuiteId
- ID of a test suite for which to run a build.
ciBuildId
(optional) - Your internal build ID that can help you to identify the build in Automator.
Example request:
curl -s -X POST "https://tools.automator.deepcrawl.com/start" -H "Content-Type:application/json" -d "{\"authToken\":\"{TOKEN}\",\"testSuiteId\":\"{TEST_SUITE_ID}\"}"
Response:
{
"buildId": "{BUILD_ID}"
}
Poll build
POST /poller
This endpoint polls for build status
Available params:
authToken
- Token for Graph API. You can find instruction for how to generate this token here.
BuildId
- ID of a build to check.
Exampler request:
curl -s -X POST "https://tools.automator.deepcrawl.com/poller" -H "Content-Type:application/json" -d "{\"authToken\":\"{TOKEN}\",\"buildId\":"{BUILD_ID}"}"
If build is still running the response HTTP status will be 202
and the body will be empty.
If build has finished running the response HTTP status will be 200
and the example body will look like this:
{
"id": "{BUILD_ID}",
"status": "Finished",
"passed": true
}