Setting up an external application
To enable Tracker to exchange data with an application, configure basic link functionality: network access and authentication.
To ensure that Tracker supports advanced functionality of links to your application, such as displaying detailed information about linked objects, you need to implement support for these features in the application.
Configuring basic link functionality
Network access
Your application must be available via a public address on the internet.
Authentication
To authenticate requests sent from Tracker to external applications, you can use one of the following approaches:
-
Without authentication
-
OAuth
A token used to authenticate a request from Tracker to an external application is passed in the request header.
Link management in Tracker
Use the Tracker API to create or remove links to your external application:
- Getting a list of external applications
- Getting a list of issue external links
- Adding an external link
- Deleting an external link
Configuring advanced link functionality
Getting information about linked objects
To enable the Tracker interface to display detailed information about a linked object, the application should pass the following information upon request:
-
Method: GET
-
URL:
scheme://host:port*{{remoteKey}}*
where:
remoteKey
is the key of the linked object in the application.*
is any sequence of characters.
For example:
https://my-app.ru:8080/1234/info
Expected response format: A list of parameters in JSON format.
Parameter |
Type |
Description |
|
String |
Object key. Required. |
|
String |
Object name. Required. |
|
String |
Icon URL. Optional. |
|
Object |
Object status. Optional.
|
|
Object |
Resolution. Optional.
|
|
Object |
Assignee. Optional.
|
|
String |
Update date and time in |
|
String |
Deadline in |