查询 TAPD 迭代列表
tapd_list_iterationsRead-only
Retrieve a list of iterations from a TAPD project with filters by ID, name, status, and more. Use this to select the correct iteration for creating or updating requirements.
Instructions
查询 TAPD 项目迭代列表，支持按迭代 ID、名称、状态过滤，以及描述、起止时间、迭代类别、计划应用、创建人、创建/修改/完成时间、锁定人、自定义字段等，并可自定义排序（order）与翻页；用于创建或更新需求时选择 iteration_id
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | 迭代 ID，TAPD 支持多 ID 查询 | |
| name | No | 迭代名称，TAPD 支持模糊匹配 | |
| page | No | 页码，默认 1 | |
| limit | No | 返回数量上限，默认 50，最大 200 | |
| order | No | 可选，排序规则，格式「字段名 asc|desc」（如 created desc），不传默认 modified desc | |
| locker | No | 可选，锁定人 TAPD nick | |
| status | No | 迭代状态，系统状态为 open（开启）/done（已关闭），自定义状态可传中文名 | |
| created | No | 可选，创建时间，TAPD 支持时间查询 | |
| creator | No | 可选，创建人 TAPD nick | |
| enddate | No | 可选，结束时间，TAPD 支持时间查询 | |
| modified | No | 可选，最后修改时间，TAPD 支持时间查询 | |
| completed | No | 可选，完成时间 | |
| startdate | No | 可选，开始时间，TAPD 支持时间查询 | |
| description | No | 可选，详细描述 | |
| plan_app_id | No | 可选，计划应用 ID | |
| workspace_id | Yes | TAPD 项目 ID（必填）。可先用 tapd_list_bugs / tapd_list_stories 跨项目查询，或 tapd_list_workspaces 获取目标项目 ID | |
| custom_fields | No | 可选，自定义字段过滤透传。key 为 TAPD 字段名（custom_field_*、cus_* 或 custom_plan_field_*），原样提交；具体字段名通过 TAPD 自定义字段配置接口获取 | |
| workitem_type_id | No | 可选，迭代类别 ID |