获取项目下需求的数量
- curl 使用 Basic Auth 鉴权调用示例
- 返回结果
获取项目下优先级为 High 需求的数量
- curl 使用 Basic Auth 鉴权调用示例
- 返回结果
需求优先级(priority)取值字段说明

# 说明

计算符合查询条件的需求数量并返回

# url

https://api.tapd.cn/stories/count

# 支持格式

JSON/XML（默认JSON格式）

# HTTP请求方式

GET

# 请求数限制

只返回需求数量

# 请求参数

字段名	必选	类型及范围	说明	特殊规则
id	否	integer	ID	支持多ID查询
name	否	string	标题	支持模糊匹配
priority	否	string	优先级。为了兼容自定义优先级，`请使用 priority_label 字段`，详情参考：如何兼容自定义优先级
priority_label	否	string	优先级。推荐使用这个字段
business_value	否	integer	业务价值
status	否	string	状态	支持枚举查询
label	否	string	标签查询	支持枚举查询，5月30号上线
version	否	string	版本
module	否	string	模块
test_focus	否	string	测试重点
size	否	integer	规模
owner	否	string	处理人	支持模糊匹配
cc	否	string	抄送人	支持模糊匹配
creator	否	string	创建人	支持模糊匹配
developer	否	string	开发人员
begin	否	date	预计开始	支持时间查询
due	否	date	预计结束	支持时间查询
created	否	datetime	创建时间	支持时间查询
modified	否	datetime	最后修改时间	支持时间查询
completed	否	datetime	完成时间	支持时间查询
iteration_id	否	integer	迭代	支持不等于查询
effort	否	string	预估工时
effort_completed	否	string	完成工时
remain	否	float	剩余工时
exceed	否	float	超出工时
category_id	否	integer	需求分类	支持枚举查询
workitem_type_id	否	integer	需求类别ID	支持枚举查询
release_id	否	integer	发布计划
source	否	string	来源
type	否	string	类型
parent_id	否	integer	父需求
children_id	否	string	子需求
description	否	string	详细描述	支持模糊匹配
workspace_id	`是`	integer	项目ID
custom_field_*	否	string或者integer	自定义字段参数，具体字段名通过接口获取需求自定义字段配置获取	支持枚举查询
custom_plan_field_*	否	string或者integer	自定义计划应用参数，具体字段名通过接口获取自定义计划应用获取

# 调用示例及返回结果

# 获取项目下需求的数量

# curl 使用 Basic Auth 鉴权调用示例

curl -u 'api_user:api_password' 'https://api.tapd.cn/stories/count?workspace_id=10158231'

# 返回结果

{
    "status": 1,
    "data": {
        "count": 7
    },
    "info": "success"
}

1
2
3
4
5
6
7

# 获取项目下优先级为 High 需求的数量

# curl 使用 Basic Auth 鉴权调用示例

curl -u 'api_user:api_password' 'https://api.tapd.cn/stories/count?workspace_id=10158231&priority=4'

# 返回结果

{
    "status": 1,
    "data": {
        "count": 4
    },
    "info": "success"
}

1
2
3
4
5
6
7

# 需求优先级(priority)取值字段说明

为了兼容自定义优先级，请使用 priority_label 字段，详情参考：如何兼容自定义优先级。下面取值将不再使用。

取值	字面值
4	High
3	Middle
2	Low
1	Nice To Have

← 获取需求获取保密需求 →