【初心者向け】Jira REST APIの使い方　~基礎編~

はじめに

プロジェクト管理ツールとして広く利用されているJiraは、課題管理や進捗の可視化を行うために非常に強力な機能を提供しています。

しかし、プロジェクトの規模が大きくなり、チームが増えるにつれて、毎回手動で課題を作成したり、更新したりするのは非常に非効率です。

そんなときに役立つのがJira REST APIです。

このAPIを使うと、Jiraの課題やプロジェクト情報にプログラムから直接アクセスし、自動で操作を行うことが可能です。

この記事では、Jira REST APIの基礎から具体的な使用方法までをわかりやすく解説していきます。

Jira Rest APIのより実践的な使い方を学びたい方は、【実践】Python×Jira APIでチケット取得＆Slack通知！をご確認ください。

Jira REST APIとは？

Jira REST APIは、外部アプリケーションやシステムがJiraにアクセスして、課題（チケット）の作成、更新、削除、プロジェクト情報の取得などを行うためのツールです。

HTTPリクエストを使って簡単にJiraデータにアクセスできるため、プロジェクト管理を自動化したり、他のツールと統合するのに非常に便利です。

Jira REST APIでできることは、Jiraの公式ドキュメントにもありますが、読み解くのは大変なので以下の3つのポイントを抜粋して簡潔にまとめました。

様々なAPIの説明がまとめられている公式ドキュメントの見方は、【初心者向け】Jira REST APIの公式ドキュメントの見方をやさしく解説！ | システムエンジニアの備忘録で紹介しているので是非参考にしてみてください。

Jira REST APIを利用するための準備

APIトークンの取得

Jira REST APIへのアクセスには認証が必要で、そのために「APIトークン」を使用します。以下の手順でAPIトークンを取得します。

1. AtlassianのAPIトークンページにログインします。
2. 「APIトークンを作成する」をクリックして、新しいトークンを作成します。
3. トークンの名前を入力し、「作成」をクリック。
4. 生成されたAPIトークンをコピーし、安全に保管します。　※これ以降トークンは確認できないので確実に保管してください。

Postmanのインストール

PostmanはAPIを使ってデータのやり取りをテストしたり、確認したりするために非常に便利なツールです。

公式サイトからインストールしてください。

Jira REST APIの利用方法

ここでは、Postmanを使ってJira REST APIを利用する方法を紹介します。
例として、課題（チケット）情報を取得する方法を説明します。

リクエストの作成

1. Postmanを開き、画面左上の「+」をクリックして新しいリクエストを作成します。
2. HTTPメソッドは「GET」を選択します。
3. URLには、Jiraの課題取得用エンドポイントを入力します。

認証の設定

1. Authorization（認可）タブをクリックします。
2. Auth Typeのドロップダウンで「Basic 認証」を選択します。
3. ユーザー名には、あなたのJiraアカウントのメールアドレスを入力します。
4. パスワードには、事前準備で取得したJiraのAPIトークンを入力します。

リクエストの送信

リクエストの作成と認証の設定が完了したら、「送信」ボタンをクリックしAPIを呼び出します。

すると、課題（チケット）の情報を取得することができます。

まとめ

さらに学びたい方へ

「ワンランク上のビジネススキルを身につけたい」

そんな方に注目されているのが、オンライン学習サービスです。

中でも特におすすめなのが、人気の2大サービスSchoo(スクー) とUdemy(ユーデミー) 。

特徴や違いを比較しながら、あなたに合った選び方をわかりやすく解説します。

SchooとUdemyの特徴は？

項目	Schoo(スクー)	Udemy(ユーデミー)
学習スタイル	ライブ配信 オンデマンド動画	オンデマンド動画
対象ジャンル	あらゆるジャンル	あらゆるジャンル
料金体系	月額980円　※無料授業あり	講座ごとの買い切り（セール時は1,200円前後~）
言語	日本語のみ	多言語対応（65言語以上）
向いている人	IT/ビジネススキルなど幅広く学びたい方 長期的に学びたい方	特定のスキルを深く学びたい方 短期集中で学びたい方
おすすめ度	5.0	4.5

あなたに向いているのはSchoo？Udemy？