最近想在项目里免密登录并创建需求到禅道,搜了一下很多教登录的,但是怎么也找不到需求相关.json路径的api,最后经点拨自己下载一个禅道试试。

我下载的是15.0.3开源版本,具体下载安装指路-

启动之后,用postman调用user-login.json如果出现401报错,那可以试试把启用Apache用户访问验证前面的勾选去掉,如图,再调接口就可以了。

禅道 java版源代码 禅道 api_java

接下来就是找需求相关的api了,后台-->二次开发-->API,想看哪个模块的API直接点就可以了:

禅道 java版源代码 禅道 api_API_02

API有了,开始实操,我需要的是创建用户需求,但是发现页面上并没有用户需求,打开个性化设置,发现只有这几种,倒是也不影响,反正看api里也有type参数,接下来就是调用了;

禅道 java版源代码 禅道 api_API_03

这里贴一下我自己的调用,产品和分支要自己先创建好,其他的东西用不上的都传0,我要创建用户需求所以type是requirement,研发需求的type用story:

 

禅道 java版源代码 禅道 api_禅道 java版源代码_04

tip:如果参数是不需要评审,那么创建成功就是激活状态;如果需要评审但是没有指派评审人,那么创建之后就是草稿状态,要通过评审才能激活。当前版本可以看到默认是需要评审的,所以needNotReview参数不传就会是草稿状态;

重点:我按照API的post参数加的,每次创建完一看都是研发需求,最后发现post参数也要加一个type,这样才能创建用户需求!

创建结束之后是变更,可以看到禅道给的api只给了这一个参数,但是没关系,多试几次,看看创建接口那边的参数,试着去调用一下,果然,变更成功=.=

禅道 java版源代码 禅道 api_禅道 java版源代码_05

禅道 java版源代码 禅道 api_禅道 java版源代码_06

 其他的像激活、关闭需求接口,也是需要加参数的,我是通过页面拿到的,比如说:

/zentao/story-activate-[storyID].json 激活需求,参数如图:

禅道 java版源代码 禅道 api_postman_07

 /zentao/story-close-[storyID].json 关闭需求,参数如图:

禅道 java版源代码 禅道 api_API_08

 其他的接口有时间再多试试,先总结到这里了~

======================2023.12.21=========================

发现上面指路的链接没法免费看了,所以去找了一下禅道下载版本历史的地址:

小伙伴们可以到这里去找需要的版本

======================2024.05.09==========================

 添加测试用例接口,API地址如图:

禅道 java版源代码 禅道 api_java_09

实际页面添加时,f12查看之后发现只需要 /zentao/testcase-create-[product]-[storyID]-[moduleID].json 就够了,如图:

禅道 java版源代码 禅道 api_json_10