可视化评审讨论 API

  • 引入于极狐GitLab 12.5。
  • 移动到极狐GitLab 专业版于 13.9。
caution 此功能废弃于极狐GitLab 15.8,并计划于 17.0 移除。此为突破性变更。

创建新的合并请求主题

为单个项目合并请求创建一个新的主题。类似于创建注释,但稍后可以添加其他评论(回复)。

POST /projects/:id/merge_requests/:merge_request_iid/visual_review_discussions

参数:

参数 类型 是否必需 描述
id integer/string yes ID 或 URL 编码的项目路径
merge_request_iid integer yes 合并请求 IID
body string yes 主题的内容
position hash no 创建差异注释时的位置
position[base_sha] string yes 源分支中的基础提交 SHA
position[start_sha] string yes 在目标分支中引用提交的 SHA
position[head_sha] string yes 引用此合并请求的 HEAD 的 SHA
position[position_type] string yes 位置引用的类型:textimage
position[new_path] string no 更改后的文件路径
position[new_line] integer no 更改后的行数(仅为 text 差异注释存储)
position[old_path] string no 更改前的文件路径
position[old_line] integer no 更改前的行数(仅为 text 差异注释存储)
position[width] integer no 图片宽度(仅为 image 差异注释存储)
position[height] integer no 图片高度(仅为 image 差异注释存储)
position[x] integer no X 坐标(仅为 image 差异注释存储)
position[y] integer no Y 坐标(仅为 image 差异注释存储)
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/merge_requests/11/visual_review_discussions?body=comment"