# 说明
获取工作项与需求的所有关联关系（无分页）
# url
https://api.tapd.cn/mini_items/get_link_stories
# 支持格式
JSON/XML（默认JSON格式）
# HTTP请求方式
GET
# 请求数限制
一次返回所有符合条件的值
# 请求参数
| 字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
|---|---|---|---|---|
| workspace_id | 是 | integer | 空间ID | 无 |
| mini_item_id | 是 | integer | 19位长度的需求ID | 无 |
# 调用示例及返回结果
获取工作项 1069995388006269526 与其它需求的所有关联关系
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' 'https://api.tapd.cn/mini_items/get_link_stories?workspace_id=69995388&mini_item_id=1069995388006269526'
# curl 使用 OAuth Access Token 鉴权调用示例
curl -H 'Authorization: Bearer ACCESS_TOKEN' 'https://api.tapd.cn/mini_items/get_link_stories?workspace_id=69995388&mini_item_id=1069995388006269526'
# 返回结果
{
"status": 1,
"data": [
{
"type": "direct_relate",
"id": "1069990800856102923",
"workspace_id": "69993260",
"actas": "target",
"created": "2023-07-18 19:07:27",
"modified": "2023-07-18 19:07:27",
"linked_workspace_id": 69990800
}
],
"info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 字段说明
# 重要字段说明
| 字段 | 说明 |
|---|---|
| type | 关系类型 |
| id | 关联的需求ID |
| workspace_id | 关联操作发生的空间ID |
| linked_workspace_id | 关联需求所在的空间ID |
| actas | 角色。target 为操作发起方 |
# 关联类型说明
| 关联类型 | 说明 |
|---|---|
| direct_relate | 直接关联 |
| copy | 转需求或需求转工作项 |
| sync_copy | 转需求或需求转工作项(同步字段) |