Jira is a suite of agile work management tools that powers collaboration across all teams from concept to customer. Jira offers capabilities, that enables operation of software development, IT business flows, development operations and much more.
Jira – as a ticketing system - can be integrated with other tools. As part of Atlassian tool family, it provides the ability to create scripts and develop integration or build functionalities that simplify complex tasks and automate routine activities.
API users would typically perform the following operations:
• Authenticate via personal access tokens
• Get information about issues and other data entities in the system
• Manipulate with issues, boards, sprints and other elements via CRUD operations (GET, PUT, POST, and DELETE)
• Integrate with source code repositories (like Git)
URL: jira.dhl.com
Scope
Jira provides REST API that you can interact with using http requests, curl, or third party libraries. This page will enable you the access to ITS Instance of Jira via published end-points.
Using the API
The easiest way to get started with the API is to get information about a particular issue. For this, head over to your browser or command line window and continue with the following section.
Example Use Cases
Get issue information
This example get information about particular issue based on its ID.
Curl Example: curl -D- --X GET -H "Content-Type: application/josh" -H "Authorization: Bearer <token>"https://apihub-int.dhl.com/jira/v1/issue/<ticket id>
Get list of projects
The following command fetches the list of projects, that is accessible by particular user.
Curl Example: curl -D- --X GET -H "Content-Type: application/Jason" -H "Authorization: Bearer <token>" https://apihub-int.dhl.com/jira/v1/project
Fetch boards
The following command gets list of boards, that are basic entities in Jira to manage the agile process.
Curl Example: curl -D- --X GET -H "Content-Type: application/json" -H "Authorization: Bearer <token>" https://apihub-int.dhl.com/jira/v1/board
These examples are just the first steps to get familiar with Jira API.
Get Access
For REST API you need to authenticate to the Jira server. For that you need to get your personal access token, so you van authenticate to Jira. For the automated-process type of calling (e.g. tool-tool) you should use a system account and generate the access token for the service account.
1. Log in to Jira and click on Profile under your profile icon.
2. Go to Personal Access Tokens and click Create Token.
3. Enter the descriptive name, expiration, and click Create.
4. On the next screen make sure to copy the token and store it. This token will be used in the command line to access Jira API.
Authentication
Use token as "Authorization: Bearer <token>" to use this API.
Environments
Environment: https://apihub-int.dhl.com
Description: Production environment
Rate Limits
120pm
Additional Information
N/A
Release notes
N/A
N/A
More HTTP request example
- please change hostname and path properly (see above)
The general information about APIs can be found here:
https://developer.atlassian.com/server/confluence/confluence-server-rest-api/
The REST API documentation is publicly available on:
https://developer.atlassian.com/cloud/confluence/rest/v1/intro/#auth
https://docs.atlassian.com/ConfluenceServer/rest/8.4.0/
1.0.0
- Initial launch