# 说明
获取工作流起始状态
# url
https://api.tapd.cn/workflows/first_step
# 支持格式
JSON/XML（默认JSON格式）
# HTTP请求方式
GET
# 请求数限制
一次只能获取一个项目的工作流起始状态
# 请求参数
| 字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
|---|---|---|---|---|
| workspace_id | 是 | integer | 项目ID | |
| system | 是 | string | 系统名。取 bug （缺陷的）或者 story（需求的） | |
| workitem_type_id | 否 | integer | 需求类别 |
# 调用示例及返回结果
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' 'https://api.tapd.cn/workflows/first_step?system=story&workspace_id=10104801&workitem_type_id=1010104801000022091'
curl 'https://api.tapd.cn/workflows/first_step?system=story&workspace_id=10104801&workitem_type_id=1010104801000022091&access_token=ACCESS_TOKEN'
# 返回结果
{
"status": 1,
"data": {
"planning": "规划中"
},
"info": "success"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 返回字段说明
| 字段 | 说明 |
|---|---|
| 键 | 状态英文名 |
| :----: | :----: |
| 值 | 状态中文名 |
| :----: | :----: |