获取Token

1. Token

1.1 获取Token

2. 用户

2.1 获取我的个人信息

2.2 获取用户列表

2.3 获取用户信息

2.4 修改用户信息

2.5 删除用户

2.6 创建用户

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 获取测试单详情

15. 反馈

15.1 创建反馈

15.2 指派反馈

15.3 关闭反馈

15.4 删除反馈

15.5 修改反馈

15.6 获取反馈详情

15.7 获取反馈列表

2022-03-17 13:28:02

王怡栋

8667

最后编辑：王怡栋于 2022-03-17 14:25:39

分享链接

POST

/tokens

请求体

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

请求示例

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

请求响应

名称	类型	必填	描述
token	string	否

响应示例

{
    "token": "cuejkiesahl9k1j8be5bv5lndo"
}

发表评论

评论列表

2022-08-02 19:26:22

你好，postman请求的url在哪里查看？我直接在公司本地部署的禅道后http://xx.xxxxx.com/www/index.php/v1/tokens去调postman失败，返回的登录页

2022-08-03 08:47:06 回复

使用 http://xx.xxxxx.com/www/api.php/v1/tokens 这个格式看下

2022-08-03 09:01:32 回复

亲测有效

2022-07-29 21:12:04

{
"errcode": 401,
"errmsg": "缺少code参数"
}返回了个这是啥意思？参数中也没体现code呀？

2022-08-01 08:47:55 回复

1、先确认网页可以正常访问禅道，ip要换成禅道服务器实际地址调用端口
2、确认下有在body里按这个格式传输登录禅道的用户名密码么？ {"account": "admin", "password": "123456"}
3、确认下是否启用了Apache用户访问验证导致的

2022-08-04 18:22:16 回复

我跟他的提示是一样的，禅道地址能正常访问

2022-08-04 18:32:08 回复

url可以贴一下吗？方便确认问题。或者，也可以联系官网顶部商务QQ，邀请加入技术交流群沟通。

2022-07-15 08:30:08

token的时间限制

2022-07-15 08:43:14 回复

24分钟

2022-07-20 21:13:50 回复

没有吧，我上午请求好的创建token的接口，完了现在都是可以拿着token去调其他接口的

2022-07-21 09:55:21 回复

这里是根据php.ini问中session相关参数失效的
php中session机制默认是24分钟，有1%的失效几率
可以通过调整php.ini中的参数来进行修改，修改后重启服务生效

2022-07-12 16:13:03

获得了token 怎么用。接口直接放回{"error":"Unauthorized"}。token是放在header中吗

2022-07-12 17:30:42 回复

你好，添加左上角商务qq，邀请您进入技术交流群沟通下

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 回复

可以加一下左上角的商务联系方式，商务邀请进群后可以把请求网址和传参截图出来看下

2022-07-08 16:11:36 回复

你可以将post传递的用户名和密码用json格式写到body中的raw中，即可返回token

2022-06-09 15:11:39

有操作维护模块的新api接口吗

2022-06-09 15:25:27 回复

目前还没有，后面会持续完善接口库。

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用户访问验证导致的，关掉了就好了，希望后面使用的朋友也知悉一下~~

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

请问禅道的后台表结构的说明文档在哪里有，开源版本的。

2022-04-15 13:16:58 回复

后台-二次开发-数据库可以直接查看