登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  软件教程

GitHub Copilot Code Review API 怎么提交代码审查请求

来源:17golang原创

时间:2026-10-04 12:01:33 409浏览 收藏

要把 GitHub Copilot Code Review 接入脚本,核心不是创建新的 Pull Request,而是给已有 PR 发送一次 review request。REST 调用使用 POST /repos/OWNER/REPO/pulls/PULL_NUMBER/requested_reviewers,请求体的 reviewers 数组填入 copilot-pull-request-reviewer[bot]。接口返回 201 才表示请求已创建,后续评论生成属于异步过程。

官方地址:https://docs.github.com/en/rest/pulls/review-requests

要点速览
  • 只对已有 Pull Request 请求审查,仓库名和 PR 编号必须准确。
  • reviewer 要写成 copilot-pull-request-reviewer[bot],不要把显示名当作 API 值。
  • 令牌至少要有目标仓库 Pull requests 的写权限;201 只代表请求建立成功。

先确认 Pull Request 和 reviewer 入口

先打开目标 PR,确认它不是已经关闭的旧任务,并准备三个路径变量:仓库所有者 OWNER、仓库名 REPO、PR 编号 PULL_NUMBER。令牌不要直接写进脚本或文章,把它放在当前 shell 的环境变量中。Fine-grained token 需要目标仓库的 Pull requests 写权限;组织策略还必须允许 Copilot code review。

网页端的 Reviewers 区域可以帮助你做人工核对:它显示的是 PR 的审查请求状态,而 API 负责提交同一类请求。下面这张图是原创界面说明图,仅用来对应操作区域,不是 GitHub 官网截图。

GitHub Copilot Pull Request Reviewers 请求入口的原创界面说明图
图1:Pull Request reviewer 请求入口的原创界面说明图,不是 GitHub 官网截图。

用 REST 请求提交一次代码审查

API 路径中的 OWNER、REPO 和 PULL_NUMBER 要替换成真实值。请求头建议带上 Accept: application/vnd.github+json 与当前文档示例中的 X-GitHub-Api-Version: 2026-03-10。JSON 请求体保持简单,只传 reviewers 数组即可;严格 JSON 不添加注释,字段含义放在代码块外说明。

# 用环境变量承载令牌,避免把凭据写进脚本和命令历史
export GITHUB_TOKEN="替换为你的令牌"

# 对已有 Pull Request 提交 Copilot reviewer 请求
curl -L -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer ${GITHUB_TOKEN}" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  "https://api.github.com/repos/OWNER/REPO/pulls/PULL_NUMBER/requested_reviewers" \
  -d '{"reviewers":["copilot-pull-request-reviewer[bot]"]}'

这里的 Authorization 只在本地变量中展开,示例没有真实令牌。若还要指定普通用户或团队,可以在同一个请求体里增加对应的 reviewers 或 team_reviewers 项,但本篇任务只保留 Copilot reviewer,减少权限和排错变量。

下图把方法、路径、请求体和结果放在一个原创 API 工作台中,方便对照命令理解字段位置;它不表示真实请求已经在本机执行。

GitHub Copilot Code Review API POST 请求体与 201 Created 状态的原创界面说明图
图2:REST 请求字段与创建成功状态的原创界面说明图,不是实际运行截图。

按响应码判断请求是否真的提交

响应含义处理动作
201 Createdreview request 已创建回到 PR 的 Reviewers 或时间线等待评论
403 Forbidden令牌或仓库权限不足检查 Pull requests 写权限和组织策略
422 Unprocessable Entity请求参数或协作者条件不满足核对 reviewer、仓库、PR 编号和访问关系
503 Service unavailable服务暂时不可用记录响应后稍后重试,避免无间隔重复提交

201 并不等于审查评论已经出现。提交成功后,Copilot 才会异步处理 PR;如果 PR 已经产生新的提交,是否自动重新审查还取决于仓库的自动审查设置。重复点击或重复发送前,先查看当前 requested reviewers,避免把排队问题误判成接口失败。

常见问题

可以把 reviewer 写成 @copilot 吗?

@copilot 是命令行或界面中的便捷写法;REST 请求按官方说明使用 copilot-pull-request-reviewer[bot] 更稳妥。

为什么返回 201 但暂时看不到评论?

201 只确认审查请求创建成功,评论生成是后续异步步骤。先在 PR 页面确认 reviewer 请求仍在,再检查 Copilot code review 是否已启用。

请求成功后会自动批准 PR 吗?

默认是 Comment review,不等同于 Approve,也不会自动满足必需审批规则。批准能力和仓库策略需要单独配置。

把这次调用拆成“定位 PR、指定 bot、判断 201、回到 PR 核对”四步,脚本就能稳定接入现有流水线;令牌权限、仓库策略和异步等待则应作为独立的运行条件管理。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>