4006-8899-23 0532-86893032
禅道API文档v1 更多
1. Token
1.1  获取Token
2. 用户
2.1  获取我的个人信息
2.2  获取用户列表
2.3  获取用户信息
2.4  修改用户信息
2.5  删除用户
3. 项目集
3.1  获取项目集列表
3.2  修改项目集
3.3  获取项目集详情
3.4  删除项目集
3.5  创建项目集
4. 产品
4.1  获取产品列表
4.2  创建产品
4.3  获取产品详情
4.4  编辑产品
4.5  删除产品
5. 产品计划
5.1  获取产品计划列表
5.2  创建计划
5.3  获取计划详情
5.4  修改计划
5.5  删除计划
5.6  产品计划关联需求
5.7  产品计划取消关联需求
5.8  产品计划关联Bug
5.9  产品计划取消关联Bug
6. 发布
6.1  获取产品发布列表
6.2  获取项目发布列表
7. 需求
7.1  获取产品需求列表
7.2  获取项目需求列表
7.3  获取执行需求列表
7.4  创建需求
7.5  获取需求详情
7.6  变更需求
7.7  修改需求其他字段
7.8  删除需求
8. 项目
8.1  获取项目列表
8.2  创建项目
8.3  获取项目详情
8.4  修改项目
8.5  删除项目
9. 版本
9.1  获取项目版本列表
9.2  获取执行版本列表
9.3  创建版本
9.4  获取版本详情
9.5  修改版本
9.6  删除版本
10. 执行
10.1  获取项目的执行列表
10.2  创建执行
10.3  查看执行详情
10.4  修改执行
10.5  删除执行
11. 任务
11.1  获取执行任务列表
11.2  创建任务
11.3  获取任务详情
11.4  修改任务
11.5  删除任务
12. Bug
12.1  获取产品Bug列表
12.2  创建Bug
12.3  获取Bug详情
12.4  修改Bug
12.5  删除Bug
13. 用例
13.1  获取产品用例列表
13.2  创建用例
13.3  获取用例详情
13.4  修改用例
13.5  删除用例
14. 测试单
14.1  获取测试单列表
14.2  获取项目的测试单
14.3  获取测试单详情

获取Token

2022-03-17 13:28:02
王怡栋
5605
最后编辑：王怡栋 于 2022-03-17 14:25:39
分享链接
POST
/tokens

获取Token

请求体

名称 类型 必填 描述
account string 否 登录名
password string 否 密码

请求示例 

{"account": "admin", "password": "123456"}

请求响应

名称 类型 必填 描述
token string 否

响应示例 

{
    "token": "cuejkiesahl9k1j8be5bv5lndo"
}
发表评论
评论列表
王勇 2022-06-09 16:49:04
你好，我这里禅道使用的是15.5版本，使用postman，http://192.168.199.68:80/zentao/api.php/v1/tokens ，选择POST，在Body下使用参数（KEY VALUE）account:tester123456 password:Test123456 ,发送请求后返回结果是{"error":"EMPTY_ENTRY"}。我测试过：使用http://192.168.199.68:80/zentao在浏览器中打开能正常打开禅道，使用tester123456/Test123456 能登录禅道。请问这个要怎么处理？
禅道-阿龙 2022-06-09 16:58:13 回复
当前版本不能最新的接口方式，可以升级到禅道17.0版本，升级前请做好数据备份
升级请参考文档：http://www.zentao.net/book/zentaopmshelp/41.html
备份请参考文档：http://www.zentao.net/book/zentaopmshelp/42.html
王勇 2022-06-09 17:10:47 回复
好，谢谢。我升级试试。
王勇 2022-06-13 19:33:57 回复
你好，我重新换了一台机器部署了最新版的禅道：17.0 然后使用admin登录，修改密码，创建了用户、产品、项目等等。创建了用户tester001，密码test123456 并且使用tester001登录成功，但是使用postman发送请求，url是http://XXX.XXX.XXX.XX:80/zentao/api.php/v1/tokens 使用POST方式，Body(form-data)里数据 account：tester001 password：test123456
返回结果是：{
"error": "登录失败，请检查您的用户名或密码是否填写正确。"
}
请问这是什么原因？
王勇 2022-06-13 19:36:06 回复
我还创建了其他的用户，在浏览器里可以登录禅道成功，但是使用postman就是返回{
"error": "登录失败，请检查您的用户名或密码是否填写正确。"
}
禅道-阿龙 2022-06-14 13:39:08 回复
后台-人员-权限中，API接口分组中相关权限开通下在测试；或者可以使用admin用户测试下。
王勇 2022-06-15 11:18:31 回复
2种方法都试过了：1、给普通用户开放API权限。后台-人员-权限-->权限维护，勾选API接口、二次开发，保存；2、使用admin。
还是返回：{
"error": "登录失败，请检查您的用户名或密码是否填写正确。"
}
其中postman 显示 Status:400 Bad Request (The request cannot be fulfilled due to bad syntax.)
马超 2022-06-15 17:51:07 回复
可以加一下左上角的商务联系方式，商务邀请进群后可以把请求网址和传参截图出来看下
AA 2022-06-09 15:11:39
有操作 维护模块 的新api接口吗
禅道-阿龙 2022-06-09 15:25:27 回复
目前还没有，后面会持续完善接口库。
AA 2022-06-07 18:29:51
这个文档中接口和后台-二次开发-API中的接口差别有点大啊，应该用哪种了？
王林 2022-06-08 08:17:48 回复
这是两种调用方式。
当前这个文档是restful风格的，建议使用新的接口就可以。
接口可以在文档-接口库中进行查看
高先生 2022-05-19 18:47:52
你好，api尝试用了postman做了请求，发现是报401，请问我该如何排查错误呢？
版本是16.5的windows一键安装版，请求路径为127.0.0.1/zentao/api.php/v1/tokens。谢谢
王林 2022-05-20 08:20:23 回复
1、127.0.0.1是本地ip，确认下是在禅道服务器本地进行调用的吗？如果是访问机器，先确认网页可以正常访问禅道，127.0.0.1要换成禅道服务器实际地址调用端口
2、确认下有在body里按这个格式传输登录禅道的用户名密码么？ {"account": "admin", "password": "123456"}
另外，可以添加QQ2334544094邀请进群后截图咨询一下
高先生 2022-05-20 09:34:53 回复
感谢你的解答，我试了一下，原来是启用了Apache用户访问验证导致的，关掉了就好了，希望后面使用的朋友也知悉一下~~
kk 2022-04-17 11:59:16
这个接口只能是新版本的使用吗？旧版的9.6不能使用对吧
禅道-阿龙 2022-04-18 08:19:46 回复
是的，这个是新版本的Restful格式API的调用方式，可以升级前下禅道版本，升级前请做好数据备份：
升级请参考文档：http://www.zentao.net/book/zentaopmshelp/41.html
备份请参考文档：http://www.zentao.net/book/zentaopmshelp/42.html
王先生 2022-04-14 18:13:46
请问禅道的后台表结构的说明文档在哪里有，开源版本的。
cuiping 2022-04-15 13:16:58 回复
后台-二次开发-数据库 可以直接查看
王先生 2022-04-13 15:30:42
请问token的有效期是多长时间？间隔多久需要重新刷新token？
cuiping 2022-04-13 17:09:26 回复
token根据时间获取的，每次都需要获取一下
王先生 2022-04-13 17:31:53 回复
每次都获取不是很繁琐？对系统也有压力？没有类似于微信的token超时机制？这样可以利用缓存大量减少请求token的次数
禅道 - 闫敏 2022-04-14 17:05:16 回复
tokenb生成所需的参数只有时间戳是动态的 , 其他参数只在第一次配置的时候需要, 后续是固定的字符串 , 没有系统压力 , 单个token只存活于一次的请求
王 2022-04-02 16:27:19
企业版6.2的登录api是多少呢
于涛 2022-04-02 16:58:50 回复
关于新版本的API接口调用可以参考下这个文档https://www.yuque.com/a.long/skku4v
王 2022-04-02 17:49:14 回复
按照文档请求会报404，请问是什么原因吗
于涛 2022-04-06 09:07:45 回复
需要注意下请求的URL地址，默认禅道地址是有一个基路径的，请求时需要添加这个路径，具体可以看下系统内文档库-接口库-编辑接口库，有一个基路径，在这个基路径后添加请求的tokens地址。
王 2022-04-06 09:25:06 回复
可以直接给样例链接吗，我目前没有看到这个文档库
于涛 2022-04-06 14:05:01 回复
可以尝试访问这个地址看下xxxxxxx/api.php/v1/tokens
王 2022-04-07 09:25:29 回复
是否可以新增加一个修改用例结果的api，
于涛 2022-04-07 14:17:32 回复
您好，目前用例的结果都是系统根据实际用例执行情况进行判断的，目前还不支持直接调用接口进行批量修改
王 2022-04-12 09:53:41 回复
后续会有这方面的考虑吗
禅道 - 闫敏 2022-04-12 14:57:45 回复
目前暂时没有这块的计划呢
易先生 2022-03-29 22:33:34
16版本，按该方式json结构 请求，没有返回token内容.
王林 2022-03-30 08:53:21 回复
新版api请求的url是： ip:端口/zentao/api.php/v1/tokens
可以看下能获取到么
易先生 2022-03-30 11:39:09 回复
昨晚再其他一篇回复中找到了，文档中没看到
禅道-阿龙 2022-03-30 13:12:51 回复
问题解决就好。
Jerma 2022-06-10 10:25:23 回复
可以麻烦贴一下解决方法的链接吗，谢谢了
王林 2022-06-10 11:26:36 回复
ip:端口/zentao/api.php/v1/tokens
看下通过上面这种请求方式无法获取到token吗？
可以添加下页面上方QQ，邀请进群后截图下咱们请求方式咨询一下呢
小跑 2022-04-06 12:45:05 回复
用postman测试调用接口报错呢，是方式不对吗？有调用例子吗
于涛 2022-04-06 14:06:27 回复
可以参考下这个例子：
一键安装包企业版调用接口请求地址：127.0.0.1:8080/biz/api.php/v1/tokens（实际请求地址为具体的访问IP地址）
小跑 2022-04-06 14:21:16 回复
感觉是版本太低了，这个接口最低支持哪个版本呀
于涛 2022-04-06 17:36:28 回复
这个新版本的接口16.0之后可以用哦
1/1
发表评论
评论通过审核后显示。