# 说明
返回符合查询条件的所有评论（分页显示，默认一页30条）
# url
https://api.tapd.cn/comments
# 支持格式
JSON/XML（默认JSON格式）
# HTTP请求方式
GET
# 请求数限制
默认返回 30 条。可通过传 limit 参数设置，最大取 200。也可以传 page 参数翻页
# 请求参数
| 字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
|---|---|---|---|---|
| id | 否 | integer | 评论ID | 支持多ID查询 |
| title | 否 | string | 标题 | |
| description | 否 | string | 内容 | |
| author | 否 | string | 评论人 | |
| entry_type | 否 | string | 评论类型（取值： bug、 bug_remark （流转缺陷时候的评论）、 stories、 tasks 。多个类型间以竖线隔开） | 支持枚举查询 |
| entry_id | 否 | integer | 评论所依附的业务对象实体id | |
| created | 否 | datetime | 创建时间 | 支持时间查询 |
| modified | 否 | datetime | 最后更改时间 | 支持时间查询 |
| workspace_id | 是 | integer | 项目ID | |
| root_id | 否 | integer | 根评论ID | |
| reply_id | 否 | integer | 评论回复的ID | |
| limit | 否 | integer | 设置返回数量限制，默认为30 | |
| page | 否 | integer | 返回当前数量限制下第N页的数据，默认为1（第一页） | |
| order | 否 | string | 排序规则，规则：字段名 ASC或者DESC，然后 urlencode | 如按创建时间逆序：order=created%20desc |
| fields | 否 | string | 设置获取的字段，多个字段间以','逗号隔开 |
# 调用示例及返回结果
# 获取项目下评论
# curl 调用示例
curl -u 'api_user:api_password' 'https://api.tapd.cn/comments?workspace_id=10104801'
# 返回结果
{
"status": 1,
"data": [
{
"Comment": {
"id": "1010104801048492751",
"title": "流转状态从 [规划中] 到 [实现中] 添加",
"description": "<b><i><u>adfasd</u></i></b>",
"author": "v_xuanfang",
"entry_type": "stories",
"entry_id": "1010104801858505231",
"created": "2020-06-09 10:51:06",
"modified": "2020-06-09 10:51:06",
"workspace_id": "10104801"
}
},
{
"Comment": {
"id": "1010104801047373797",
"title": "流转状态从 [规划中] 到 [实现中] 添加",
"description": "<b><i><u>adfasd</u></i></b>",
"author": "v_xuanfang",
"entry_type": "stories",
"entry_id": "1010104801856464295",
"created": "2020-04-26 10:44:29",
"modified": "2020-04-26 10:44:29",
"workspace_id": "10104801"
}
}
],
"info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 获取某条缺陷的评论
# curl 调用示例
curl -u 'api_user:api_password' 'https://api.tapd.cn/comments?entry_type=bug|bug_remark&entry_id=1010104801074085199&limit=2&workspace_id=10104801'
# 返回结果
{
"status": 1,
"data": [
{
"Comment": {
"id": "1010104801042258591",
"title": "在状态 [新] 添加",
"description": "<div>&nbsp;撒大大爱上大</div>",
"author": "v_xuanfang",
"entry_type": "bug",
"entry_id": "1010104801074085199",
"created": "2019-08-29 14:24:44",
"modified": "2019-08-29 14:24:44",
"workspace_id": "10104801"
}
}
],
"info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 评论字段说明
# 评论重要字段说明
| 字段 | 说明 |
|---|---|
| id | 评论ID |
| title | 标题 |
| description | 内容 |
| author | 评论人 |
| entry_type | 评论类型（取值： bug、 bug_remark （流转缺陷时候的评论）、 stories、 tasks、wiki 。多个类型间以竖线隔开） |
| entry_id | 评论所依附的业务对象实体id |
| created | 创建时间 |
| modified | 最后更改时间 |
| workspace_id | 项目ID |
| root_id | 根评论ID |
| reply_id | 评论回复的ID |