说明

计算符合查询条件的迭代数量并返回

SDK 方法名

nodeJs:

SDK使用方式 (opens new window)

插件中使用SDK

方法名::

getIterationsCount

url

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

支持格式

JSON/XML（默认JSON格式）

HTTP请求方式

GET

请求数限制

只返回迭代数量

请求参数

字段名	必选	类型及范围	说明	特殊规则
id	否	integer	ID	支持多ID查询
name	否	string	标题	支持模糊匹配
workspace_id	是	integer	项目ID
description	否	string	详细描述
startdate	否	date	开始时间
enddate	否	date	结束时间
workitem_type_id	否	integer	迭代类别
plan_app_id	否	integer	计划应用ID
status	否	string	状态
creator	否	string	创建人
created	否	datetime	创建时间	支持时间查询
modified	否	datetime	最后修改时间	支持时间查询
completed	否	datetime	完成时间
custom_field_*	否	string或者integer	自定义字段参数

调用示例及返回结果

获取项目下迭代数量

curl 使用 Basic Auth 鉴权调用示例

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

返回结果

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

迭代状态(status)字段说明

字段值	状态名
open	开启
done	已关闭