Integrate with API

Autify API

Autify provides an API.

By using the API, you can integrate with CI/CD tools such as CircleCI and Jenkins, and it can be included in the development flow, such as executing a specific test plan automatically when the source code is merged.
Access tokens are generated for each user. If you would like to share them, we recommend creating a user specifically for the API!

Issue a personal access token

You will need a personal access token to use APIs, so make sure you generate one in advance.
Access tokens are generated for each user. If you would like to share them, we recommend creating a user specifically for the API!

To generate a personal access token, go to [Settings] in the side menu, open [User settings], and click create button on [Generate Personal Access Token].

Using Autify API

With Autify CLI

Autify Command Line Interface (CLI) provides low level commands for each Autify API so that you can create any solutions by shell script or equivalent easily.

A few examples with Autify CLI:

Run a test with the specified Scenario IDs and execution environments (capabilities)

$ autify web api execute-scenarios --project-id 0 --execute-scenarios-request '{
  "scenarios": [{"id": 111}],
  "capabilities": [{"os": "Linux", "browser": "Chrome"}]
}'

{
  "result_id": 222
}

Get a detailed test result for a given Test Result ID

$ autify web api describe-result --project-id 0 --result-id 222
{
  "id": 222,
  "status": "passed",
  "review_needed": false,
  "test_plan_capability_results": [
    {
      "id": 333,
      "capability": {
        "os": "Linux",
        "browser": "Chrome",
        ...
      },
      "test_case_results": [
        {
          "id": 444,
          "status": "passed",
          "project_url": "https://app.autify.com/...",
          "review_needed": 0,
          ...
        }
      ]
    }
  ],
  ...
}

See GitHub readme for autify web api commands for more details.

Your HTTP client

If you want to integrate with Autify API and your own HTTP client e.g. curl, you can configure your client to send an HTTP request like below:

Run a test with the specified Scenario IDs and execution environments (capabilities)

POST /projects/0/execute_scenarios HTTP/1.1
Accept: application/json, text/plain, */*
Content-Type: application/json
Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN
Content-Length: 77
Host: app.autify.com

{"scenarios":[{"id":111}],"capabilities":[{"os":"Linux","browser":"Chrome"}]}

Get a detailed test result for a given Test Result ID

GET /projects/0/results/222 HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN
Host: app.autify.com

See our OpenAPI definition for API specifications.