はじめに
Jiraの課題をちまちまと作成していくのが面倒なので,CSVやExcelなどからの自動インポートを試していた.
初めてのJira 〜その2:CSVを用いてIssue作成を自動化しよう〜
調べていくなかでJira REST APIを使っても課題の作成ができるということを知り,試してみたが,いくつかのエラーに直面し苦戦したので一連の内容をまとめようと思う.
この記事を読んでできるようになること
- REST APIを使ってJira課題を操作できるようになる
環境
chrome拡張機能の「Talend API Tester」を用いてリクエストを送信
Macとかでcurlコマンドを使ってリクエストするときも,リクエストヘッダをこの記事に合わせて適切に設定すれば同じように使える(と思う.)
手順
Talend API Testerをインポート
Talend API Tester - Free Edition
インポート出来たらchromeの右上のパズルピースアイコンからTalend API Testerを立ち上げて,適当にリポジトリを作成し,その中に新規リクエストを作成する.
課題作成のリクエスト
URL
- メソッドは「POST」(取得,更新,削除など,別のことをやりたい場合は適宜変更)
- 自身のAtlassianのドメインを入れる
リクエストヘッダ
Authorization
Atlassianの以下のページからAPI Tokenを作成.
Atlassian API Tokenの作成
{mail}:{token}の形でbase64にエンコーディングした値を添付
BASIC認証の越え方
X-Attlasian-Token,User-Agent
ここを適切に設定しないと認証がうまくいかなかったり,XSRF(Cross Site Request Forgery)に関するセキュリティ回りでエラーになる.
以下の記事を参考にし,解決した.
結果だけで十分なら,上のスクショの通り値を入れればOK
Bypassing XSRF token check
XSRF check failed when calling Cloud APIs
Contet-Type,Accept
スクショの通りでOK
BODY
以下の公式ドキュメントを参考にBodyを作成
Atlassian Developer REST APIs
ここまでできれば「Send」
うまくいけばこれで課題が作成される.
終わりに
うまく使えばJiraの課題作成の自動化,効率化に役立てられそうですね.
ここまで読んでいただきありがとうございました。
この記事が何かのお役に立てれば幸いです。