API changes from v8.6.3 to v8.6.4

With the new and upcoming releases of QMetry, we continue to add exciting and useful new features that improve usability. With the new features and improvements being added to QMetry also necessitates changes in the APIs. This page enlists such APIs that will be changed from version 8.6.3 to 8.6.4 which will be released on 10th Oct for cloud customers and on 12th Oct for the server customers. The purpose of this document is to help Integration Teams keep their code updated and current with the API changes/updates to the existing APIs. In case you do not use any of these APIs, these changes can be safely ignored.


Summarized API changes

API NameREST URLMethodBackward compatibility with 8.6.3Request Change

Response Change

List of Cycles/rest/admin/cycle/listPOSTYesYesNo
Add BDD Configuration/rest/admin/bddConfiguration/addPOSTYesYesNo
Fetch Executions for Issues/rest/execution/getExecutionsForIssuePOSTYesNoYes

Updated APIs

List of Cycles

API/rest/admin/cycle/list
MethodPOST
Impact of changeLow
Backward CompatibilityYes
Reason for change

To get the list of cycle from multiple releases

ChangesUse the parameter "releaseID" in the request to specify one or more release Id.
Version 8.6.3Version 8.6.4
Request Body
{
    "start": 0,
    "limit": 10,
    "page": 1,
    "params": {
        "releaseID":10925,
		"showArchive": true
    }
}
Request Body
{
    "start": 0,
    "limit": 10,
    "page": 1,
    "params":
        {
            "releaseID": [3190,3191],
            "showArchive": true
        }
}

Add BDD Configuration

API/rest/admin/bddConfiguration/add
MethodPOST
Impact of changeLow
Backward CompatibilityYes
Reason for changeAdded support for GitLab. Git Hub can also be authenticated with new "accessToken" parameter field in request body
ChangesAdded below field in the request:
  • accessToken

GITHUB

Version 8.6.3Version 8.6.4

GITHUB

Request Body
{
    "repoSystem": "GIT",
    "url": "https://github.com/punitsamtani/amazondemo.git",
    "username": "username",
    "password": "******",
    "type": "Cloud",
    "projectID": "1257"
}

GITHUB

Request Body
{
    "repoSystem": "GIT",
    "url": "https://github.com/punitsamtani/amazondemo.git",
    "accessToken": "/agZaDrUaLjNjVI5E4eM",
    "type": "Cloud",
    "projectID": "1257"
}

GITLAB

Request Body
{
repoSystem: "GITLAB",
accessToken: "q1orrpV",
projectID: "1088",
repoSystem: "GITLAB",
url: "https://gitlab.com/neel5/bank-management.git"
}

Fetch Executions for Issues

API/rest/execution/getExecutionsForIssue
MethodPOST
Impact of changeLow
Backward CompatibilityYes
Reason for changeAdded IsPlatformArchived parameter in response to identify if the platform is archived in the execution in case of archived executions.
Changes

Added below field in the response:

  • IsPlatformArchived
Version 8.6.3Version 8.6.4
Response Body
{
    "data": [
        {
            "tcRunID": 18168519,
            "tcID": 755378,
            "dfID": 372536,
            "linkageLevel": "Test Step",
            "executedVersion": 1,
            "tcEntityKey": "PS-TC-2",
            "tcProjectIsApprovalWorkflowEnabled": false,
            "tcProjectID": 1252,
            "tcName": "Test",
            "tcAssociatedVersion": 1,
            "tcVersion": 1,
            "isArchived": false,
            "runStatusWeightage": 60000,
            "tsID": 14027,
            "tsName": "Test Suite",
            "tcApprovalStatus": 1,
            "tsEntityKey": "PS-TS-1",
            "isTestSuiteArchived": false,
            "tsProjectID": 1252,
            "tsRunID": 50606,
            "platformID": 2203,
            "platformName": "No Platform",
            "runStatusName": "notrun",
            "executionCreatedBy": 304,
            "executionCreatedByLoginID": "dhiraj",
            "executionCreatedByLoginAlias": "dhiraj",
            "executionCreatedByLoginName": "dhiraj sajagure",
            "cycleName": "Default Cycle",
            "isCycleArchived": false,
            "releaseName": "Default Release",
            "isReleaseArchived": false,
            "state": 1,
            "tsProjectIsApprovalWorkflowEnabled": false,
            "runStatusID": 8905,
            "isExecutionStatusArchived": false
        }
    ],
    "total": 1
}
Response Body
{
    "data": [
        {
            "tcRunID": 18168519,
            "tcID": 755378,
            "dfID": 372536,
            "linkageLevel": "Test Step",
            "executedVersion": 1,
            "tcEntityKey": "PS-TC-2",
            "tcProjectIsApprovalWorkflowEnabled": false,
            "tcProjectID": 1252,
            "tcName": "Test",
            "tcAssociatedVersion": 1,
            "tcVersion": 1,
            "isArchived": false,
            "runStatusWeightage": 60000,
            "tsID": 14027,
            "tsName": "Test Suite",
            "tcApprovalStatus": 1,
            "tsEntityKey": "PS-TS-1",
            "isTestSuiteArchived": false,
            "tsProjectID": 1252,
            "tsRunID": 50606,
            "platformID": 2203,
            "platformName": "No Platform",
            "isPlatformArchived": false,
            "runStatusName": "notrun",
            "executionCreatedBy": 304,
            "executionCreatedByLoginID": "dhiraj",
            "executionCreatedByLoginAlias": "dhiraj",
            "executionCreatedByLoginName": "dhiraj sajagure",
            "cycleName": "Default Cycle",
            "isCycleArchived": false,
            "releaseName": "Default Release",
            "isReleaseArchived": false,
            "state": 1,
            "tsProjectIsApprovalWorkflowEnabled": false,
            "runStatusID": 8905,
            "isExecutionStatusArchived": false
        }
    ],
    "total": 1
}