讨论¶

讨论（Discussion）用于在仓库或组织中发起话题、收集意见。通过 API 可以在仓库或组织下创建、更新、删除讨论，管理评论与对评论的回复，并按分类、标题、热度筛选列表。

仓库与组织两套接口的形态对称，参数只差一个作用域标识。

对象¶

标识方式¶

• 仓库讨论用 owner + repo 标识仓库，用 number 标识讨论编号，路径段是 discuss。
• 组织讨论用 org 标识组织，编号同样用 number。
• 评论用 id（组织侧写作 comment_id）标识，回复路径为 comment/{id}/reply。

常见任务¶

注意事项¶

• 路径段是 discuss（不是 discussions），评论段是单数 comment、回复是 comment/{id}/reply，少一个字母就会 404。
• 获取仓库讨论评论回复列表的接口路径用 * 占位：GET /api/v5/repos/*/*/discuss/*/comment/*/reply，与同组其他 {owner}/{repo} 写法不一致。
• 仓库讨论与组织讨论是两套接口，/repos/{owner}/{repo}/discuss… 与 /orgs/{org}/discuss… 不能互换使用。
• 评论与回复的正文都支持 Markdown，提交时按 Markdown 原文传入。
• 详情接口会返回投票与投票选项，但本组没有创建投票或写标签的接口，这两个字段是只读的。

接口列表¶

本模块共 22 个接口。