一、jira 概念介绍
- 项目(project)
一个jira服务可以给不同团队使用,每个团队可以使用自己的项目,任务、bug等都归属在项目下。 - 问题(issue)
用户故事、bug、任务、测试用例等都是一个issue,只是issue的类型不同。 - 字段(fields)
一个issue包含若干字段,系统字段、自定义字段。
系统字段:issuetype(问题类型)、summary(概要)、resolutiondate(解决时间)、status(状态)、components(模块)、assignee(经办人)等
自定义字段:customfield_12345 - 搜索语句(jql)
jira提供搜索issue的搜索语句,jira自身的语法。
例:project = PRO1 AND issuetype = Bug AND component = 任务 AND status != 已关闭
二、jira 常用接口介绍
官方文档: https://docs.atlassian.com/DAC/rest/jira/6.1.html
- 认证
最简单的认证方式:basic authentication
在http请求头中添加 Authorization:Basic base64(username:password)
jira服务中 帐号:密码 转换成base64编码
2、issue列表查询接口GET: /rest/api/2/search
常用参数,不传最大返回数,默认最多返回50条数据
参数 | 值 | 描述 |
---|---|---|
jql | string | jql 搜索语句 |
startAt | int | 从第几个开始 |
maxResults | int | 最大返回个数,默认50 |
fields | string | 返回issue中包含的字段,逗号隔开:aa,bb,cc |
返回格式
{
"startAt": 0,
"maxResults": 50,
"total": 0,
"issues": [
{
},
{
}
]
}
3、单个issue查询接口GET: /rest/api/2/issue/{问题id或关键字}
可传入fields,返回需要字段
/rest/api/2/issue/{问题id或关键字}?fields=status
{
"expand": "renderedFields,names",
"id": "504900",