关键字
- 阿里巴巴
- 云效RDC
- Aone
- JIRA
- 高德地图
- 德国大众
1、JIRA介绍
JIRA平台是国际上比较流行的项目缺陷追踪管理平台,与阿里云RDC(云效)系统类似,均为缺陷跟踪平台。
目前像阿里巴巴内部云效即Aone系统其实也与JIRA做了相关对接,比如高德地图-德国大众项目中就涉及Aone-Jira对接,同步两个平台的部分核心操作。所以了解下JIRA API还是有点用处,碰到了这方面的需求就可以应对。
2、JIRA REST API调用方式
2.1、权限验证
权限验证采用basic authentication这种验证方式,主要考虑到简单易行、操作方便、内部系统。具体的操作方法为在请求的http header中添加Authorization参数,取值为Basic base64(username:password),这里的username和password是企业自己部署的JIRA平台的登陆账号和密码,如下图:
通过上述方式即可完成权限验证,就上图中的项目详情接口查询的http请求来举例,下图中为请求结果:
*权限验证说明文档:https://developer.atlassian.com/cloud/jira/platform/jira-rest-api-basic-authentication/
2.2、数据请求
2.2.1、数据接口文档
*数据接口说明文档:https://developer.atlassian.com/cloud/jira/platform/rest/v2/ 目前开放的接口正式版本为v2,接口文档中的v3为公共测试版本,不要使用。
其中jql是jira自定义的一种查询语言,jira给你定义好了要如何查询,比如project项目ID,assignee票指派人,orderby排序等等,具体的可以去文档中查询。
2.2.2、问题列表查询
请求URL:https://XXX/rest/api/2/search?jql=project=10223+and+assignee=abc+order+by+updated&startAt=0&maxResults=10
请求方式:GET
返回问题详情结果:
{
"expand":"names,schema",
"startAt":0,
"maxResults":1,
"total":33,
"issues":
[
{详细问题结构参考},
{详细问题结构参考}
]
}
2.2.3、问题详情查询
请求URL:https://XXX/rest/api/2/issue/{issueIdOrKey}
请求方式:GET
返回问题详情结果:
{
"id": "10002",
"self": "http://your-domain.atlassian.net/rest/api/2/issue/10002",
"key": "EX-1",
"fields": {
"watcher": {
"self": "http://your-domain.atlassian.net/rest/api/2/issue/EX-1/watchers",
"isWa