可视化评审讨论 API 专业版
- 引入于极狐GitLab 12.5。
- 移动到极狐GitLab 专业版于 13.9。
WARNING: 此功能废弃于极狐GitLab 15.8,并计划于 17.0 移除。此为突破性变更。
创建新的合并请求主题
为单个项目合并请求创建一个新的主题。类似于创建注释,但稍后可以添加其他评论(回复)。
plaintextPOST /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 | 位置引用的类型:text 或 image |
| 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 差异注释存储) |
shellcurl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/merge_requests/11/visual_review_discussions?body=comment"