Issue¶

Issue 用于跟踪缺陷、需求与讨论。通过 API 可以创建与更新 Issue，管理评论、标签与指派，关联分支和 Pull Request，并读取表态、修改历史与操作日志。

仓库级的标签、里程碑有独立分组，本页只覆盖 Issue 自身的接口。

对象¶

标识方式¶

• 仓库级接口用 owner + repo 标识仓库，用 number 标识 Issue 编号。
• 评论级接口用 id（或 comment_id）标识具体评论，路径形如 /issues/comments/{id} 与 /issues/comment/{comment_id}/…。
• 企业级接口改用 enterprise 标识企业空间，路径以 /api/v5/enterprises/{enterprise}/ 开头。
• 组织级接口用 org 标识组织，路径以 /api/v5/orgs/{org}/ 开头。

常见任务¶

注意事项¶

• 创建与更新 Issue 的路径只带 {owner}，不带 {repo}：POST /api/v5/repos/{owner}/issues、PATCH /api/v5/repos/{owner}/issues/{number}，与同目录其他接口的 /repos/{owner}/{repo}/… 形态不同。
• 表态接口分散在两条路径上：Issue 的表态是 /issues/{number}/user_reactions，评论的表态是 /issues/comment/{comment_id}/user_reactions，注意是单数 comment。
• 删除标签时 {name} 支持用英文逗号分隔多个标签名批量删除。
• 企业级 Issue 与仓库级 Issue 是两套接口（/enterprises/{enterprise}/issues/… 与 /repos/{owner}/{repo}/issues/…），企业侧另有独立的 Issue 状态接口 /enterprises/{enterprise}/issue/statuses。
• Issue 的标签、里程碑管理接口在各自分组，本组只负责在 Issue 上挂载与摘除。

接口列表¶

本模块共 28 个接口。