GitHub企业Copilot席位管理API的应用权限、分页与取消状态如何区分

作者:工具松鼠时间:2026-11-16 12:42:38浏览:611

说明Enterprise GitHub Apps的Copilot席位管理权限,提供第一页只读GET示例,区分total_seats、授权明细、遥测活动和待取消计费条件。

GitHub在2026年11月10日为Enterprise GitHub Apps提供企业级Copilot席位管理权限。接口可读并不表示能够购买或取消,HTTP响应成功也不直接证明最终访问状态。只读GET示例可用于理解分页、总席位与授权来源明细,实际使用仍需准确的企业身份和令牌权限。

GitHub产品首页

这次新增的是应用授权路径

公告强调Enterprise GitHub Apps能够调用企业级Copilot席位管理API,不是让普通用户通过安装任意应用就获得企业管理员能力。当前接口文档支持GitHub App用户访问令牌与安装访问令牌,并将读取和写入权限分别列出。应用身份、令牌类型、企业权限与具体接口应共同匹配。

对于列出企业席位的接口,文档接受Enterprise Copilot license management读取权限,或Enterprise administration读取权限。席位购买和取消需要对应写入权限,并受企业所有者等角色条件约束。应用具有某种读取能力,不能推导出它已经有权购买席位,更不能将企业级权限与某个仓库的读写权限混为一谈。

只读查询企业席位的完整示例

以下示例适用于api.github.com,需已有获准访问目标企业的令牌,并通过安全方式预先放入COPILOT_SEAT_TOKEN环境变量。YOUR_ENTERPRISE_SLUG须替换为企业slug,不是展示名称,也不是组织名。命令仅执行GET,不购买或取消席位;这条请求只覆盖第一页、至多100条明细,后续分页不会被自动读取。

: "${COPILOT_SEAT_TOKEN:?请先通过安全方式配置获准使用的令牌环境变量}"
enterprise_slug='YOUR_ENTERPRISE_SLUG'
curl --silent --show-error --include \
  --request GET \
  --header 'Accept: application/vnd.github+json' \
  --header "Authorization: Bearer ${COPILOT_SEAT_TOKEN}" \
  --header 'X-GitHub-Api-Version: 2026-03-10' \
  "https://api.github.com/enterprises/${enterprise_slug}/copilot/billing/seats?per_page=100&page=1"

成功时预期HTTP 200,并返回total_seats与seats等数据。401、403或404分别可能涉及认证、访问被拒绝或资源不可见等条件,不能仅凭状态码确定唯一原因。命令未开启自动跟随重定向;GHE.com专属企业域名应按官方文档采用其api.SUBDOMAIN.ghe.com主机,不能把示例公共主机当作所有部署的通用地址。

GitHub官方说明Enterprise GitHub Apps席位管理与新增企业权限

去重总数、授权来源与分页分别计算什么

当前文档说明,同一用户通过多个组织或企业团队获得访问时,total_seats只计一次;但授予访问的各组织或企业团队可能分别产生seats明细。因此,不能简单拿当前页数组长度代替企业计费席位总数,也不能把多条授权来源明细误判为同一个人必然被重复计费。

分页是另一个独立因素,第一页最多100条并不意味着企业只有100条授权来源。活动时间字段也有条件:IDE活动反映到last_activity_at,需要用户在IDE中启用遥测。缺少某项活动记录不能单独证明用户从未使用Copilot,更不应直接作为取消资格的唯一依据。

分配与取消席位为什么不能只看请求已接收

添加企业团队会为指定团队中的用户购买席位并产生相应计费;取消团队则把相关成员席位置为待取消,按当前计费周期结束时处理。如果用户仍通过另一企业团队获得访问,不能由一次团队取消请求就推断其所有Copilot访问都已经终止。

这些是当前接口文档给出的行为条件,不是11月10日新权限本身取消了原有业务规则。查询结果、写入响应和用户最终可用状态属于不同证据。接口仍处于公开预览并可能变化,自动化方案应保留权限及响应语义的区别,不宜把一次HTTP成功改写成所有席位调整都已完成。

作者最新文章