JIRA实践系列-JIRA与阿里云效对接指南

JIRA实践系列-JIRA与阿里云效对接指南，拧出部分重点关联接口，便于快速上手。

一、API对照关系

api名称	云效	JIRA
创建项目	CreateDevopsProject	/rest/api/2/project
更新项目	UpdateDevopsProject	/rest/api/2/project/{projectIdOrKey}
获取项目	GetDevopsProjectInfo	/rest/api/2/project/{projectIdOrKey}
创建任务	CreateDevopsProjectTask	/rest/api/2/issue
更新任务	UpdateTaskDetail	/rest/api/2/issue/{issueIdOrKey}
添加附件		/rest/api/2/issue/{issueIdOrKey}/attachments
任务查询	GetTaskDetailBase	/rest/api/2/issue/{issueIdOrKey}

一、云效API文档¹

协作平台 Project API - 项目、任务、迭代等

云效-SDK

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-devops-rdc</artifactId>
    <version>1.0.8</version>
</dependency>

云效-项目相关API

• 创建项目 CreateDevopsProject
• 更新项目 UpdateDevopsProject
• 获取项目项列表 GetProjectOption
• 添加项目成员 InsertProjectMembers

云效-任务相关API

• 创建任务 CreateDevopsProjectTask
• 更新任务 UpdateTaskDetail
• 获取任务详情 GetTaskDetailBase

二、JIRA API文档²

JIRA API文档³ : JIRA API文档

更详细介绍参考：JIRA REST API调用方式

三、两者初略对比

阿里云效提供的api内容不太全，相对粗糙一点，比如附件相关的并没有说明；JIRA这方面则做的比较细致，均提供完整的指导说明。

总体感受即：

• JIRA流程很规范，第一眼看很复杂，第一眼看德国大众的JIRA系统时，要懵掉，一个小表格，竟然容纳了那么多的按钮。
• 云效流程简洁，用起来很简单，符合咱的使用习惯。各有千秋。但是对开发者来说，云效并不友好，从其sdk可知，已经换了n多个，各版本间有点割裂的感觉。

---

1. 协作平台 Project API - 项目、任务、迭代等 ↩︎

2. JIRA REST API调用方式 ↩︎

3. JIRA API文档 ↩︎