4006-8899-23 0532-86893032
禅道API文档v1 更多
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:38:57
王怡栋
995
分享链接
GET
/projects

获取项目列表

请求头

名称 类型 必填 描述
Token String 是 认证凭证Token

请求参数

名称 类型 必填 描述
page String 第几页，默认为1
limit String 每页项目数量，默认20

请求响应

名称 类型 必填 描述
page int 是 页数
total int 是 项目总数
limit int 是 每页项目数
projects array 是 项目列表
  ∟  id int 是 项目id
  ∟  name string 是 项目名称
  ∟  code string 是 项目编号
  ∟  model string 是 项目模型(scrum敏捷 | waterfall 瀑布)
  ∟  budget int 是 项目预算
  ∟  budgetUnit string 是 预算币种(CNY | USD)
  ∟  parent int 是 所属项目集
  ∟  begin date 是 预计开始日期
  ∟  end date 是 预计结束日期
  ∟  status string 是 项目状态(wait 未开始 | doing 进行中 | suspend 已挂起 | closed 已关闭)
  ∟  openedBy string 是 创建人
  ∟  openedDate datetime 否 创建时间
  ∟  PM string 否 项目经理
  ∟  progress int 否 进度

响应示例 

{
    "page": 1,
    "total": 2,
    "limit": 20,
    "projects": [
        {
            "id": 7,
            "name": "企业管理系统",
            "code": "",
            "model": "scrum",
            "type": "project",
            "budget": "0",
            "budgetUnit": "CNY",
            "parent": 6,
            "begin": "2021-06-05",
            "end": "2022-06-04",
            "status": "doing",
            "openedBy": "admin",
            "openedDate": "2021-04-28T03:22:04Z",
            "PM": "projectManager",
            "progress": 33
        },
        {
            "id": 8,
            "name": "分支项目",
            "code": "bb",
            "model": "scrum",
            "type": "project",
            "budget": "",
            "budgetUnit": "CNY",
            "parent": 6,
            "begin": "2021-11-23",
            "end": "2021-12-23",
            "status": "wait",
            "openedBy": "admin",
            "openedDate": "2021-11-23T07:45:16Z",
            "PM": "",
            "progress": 0
        }
    ]
}
发表评论
评论列表
xinzz 2022-07-29 17:06:11
我这边使用projects接口也是获取不到项目列表，而使用executions接口可以获取项目列表，我是前两天才升级到的禅道最新版本，请问上文回复中提到了经典模式是什么意思，与我现在的模式有什么区别吗？我又怎样去使用projects接口呢？
于涛 2022-07-29 17:27:29 回复
经典模式就是默认的产品-项目-测试 这样的概念
新模式是有项目集-产品-项目-执行的概念的，如果保持使用经典模式，接口可以继续使用executions
AA 2022-06-17 11:28:50
我禅道里有项目数据，请求zentao/api.php/v1/projects 这个地址，返回时空，这是什么原因了
金凯 2022-06-17 13:55:05 回复
您好，获取token的用户有权限在禅道中看到项目吗？接口的权限和使用的用户是一致的。您提供的信息较少，可以添加首页同事，邀请您到禅道交流群，截图看一下。
禅道4068 2022-07-26 13:13:24 回复
您好，请问问题解决了吗，我也遇到了
于涛 2022-07-26 13:25:31 回复
您好，确认下使用的是经典模式吗？如果使用的经典模式，请求的URL中projects 换成executions看下呢。
禅道4068 2022-07-26 13:37:04 回复
executions可以了，谢谢，请问经典模式的文档有吗，还是只有这一项有区别呢。
另外请问一下，比如请求url中为user-logout.json这种方式还可用吗
于涛 2022-07-26 13:46:46 回复
json方式调用是老的api方式，新版本依旧可以使用，经典模式和新模式的区别就是项目集和执行的概念，其他没有影响。
禅道4068 2022-07-26 13:54:32 回复
禅道更新到17.2版本后，json方式报错了呢，请求 http://ip/zentao/user-login.json, 返回值为{
"status": "success",
"data": "{\"title\":\"\用\户\登\录\",\"noGDLib\":\"\请\用\手\机\浏\览\器\访\问\：<strong>http:\\\/\\\/\\\/zentao\\\/<\\\/strong>\",\"referer\":\"\\\/zentao\\\/\",\"s\":\"376039517ecf4d94f28dfab4b58fe8c8\",\"keepLogin\":\"off\",\"rand\":375419757,\"unsafeSites\":{\"zentaopro\":{\"path\":\"xampp\\\/zentaopro\",\"database\":\"zentaopro\"},\"zentaobiz\":{\"path\":\"xampp\\\/zentaobiz\",\"database\":\"zentaobiz\"}},\"plugins\":{\"expiring\":[],\"expired\":[]},\"loginExpired\":false,\"pager\":null}",
"md5": "f88be8592eea09ffee7eedca5c7840ab"
}，请问您知道什么原因吗，谢谢
于涛 2022-07-26 15:38:13 回复
这个是跳转到了登录页面，确认传参中携带用户登录信息的session了吗
1/1 1
发表评论
评论通过审核后显示。