Detailed documentation on QMetry REST API provides all the details a developer would need for each of the API calls that are supported with code samples. The Headers, Body and Response provided here are for your reference only. You can use tools like Postman to try these APIs.


Overview of QMetry for Jira Open API Documentation

Go to https://qtm4jserver410.docs.apiary.io to view and try all APIs.


The main page of API documentation is divided into two sections:

A. Authentication

B. Authentication

C. Grouping of APIs



Benefits of using QMetry API tool

Authentication

The Open API needs the below two parameters for authentication.


(1) APIKeyAuth: Supply the apikey generated from the app from QMetry > Configuration > Open API.



(2) BasicAuth: Authorization (Basic authentication with Jira's credentials)

This Automation REST API is protected by the restrictions provided by Jira. You need to log in to Jira using the Basic Auth header. Follow the below steps to generate basic Auth and pass it to the request header :

1. Build a string of the form username:password

2. Encode the string in Base64 format.

3. Pass an "Authorization" header with content "Basic " followed by the encoded string. For example, the string "fred:fred" encodes to "ZnJlZDpmcmVk" in base64, so you would make the request as follows.


 Authorization:  Basic ZnJlZDpmcmVk


Grouping of APIs

You can see the groups of APIs listed on the panel at the left. Just click on the section you want to view and use the APIs of. The section is expanded on the left as well as on the right panel showing APIs under it.

To access an example of a particular API, click on it in the right panel.


For example,

You want to use the API of Create new Test Case.

  1. Expand the Test Case API group on the panel at left and select Create New Test Case API.
  2. On the right panel, again click on the Create new Test Case API. It displays relevant Examples on the third panel.


Understanding the Example

The Example panel displays corresponding details of the selected API.


Content-Type : application/json

{generated-api-key from QMetry > Configuration > Open API}

Basic ZnJlZDpmcmVk




Additional Body Parameters

To see additional parameters to be passed in the request body click on 'SHOW JSON SCHEMA'. 

See Examples here - how to use additional fields from json schema.