使用Github App集成调用API时无法标星/取消标星仓库

问题描述 #

我正尝试通过Github App调用标星仓库API，为自己的账号标星仓库。用Postman调试时，先通过应用的「login with github」获取了有效用户AccessToken（已验证该令牌可正常调用GET https://api.github.com/user/starred查询已标星仓库），但调用标星接口时返回以下错误：

{
    "message": "Resource not accessible by integration",
    "documentation_url": "https://docs.github.com/rest/reference/activity#star-a-repository-for-the-authenticated-user"
}

已配置标星仓库的权限（截图：权限配置截图），但在目标仓库安装该App时，相关选项呈灰色（截图：安装选项灰色截图），提示异常。

备注信息 #

• 此应用为Github App而非OAuth App
• 已尝试卸载重装App、重新授权获取新令牌
• 需求是代表用户为任意非自有Github仓库成功标星

核心原因 #

Github App的仓库级权限和用户OAuth授权范围是两个独立体系：

• 你配置的「Starring」权限属于仓库级权限，仅用于App以自身身份操作仓库，无法代表用户执行标星。
• 非自有仓库无法通过App安装流程授予权限，因此安装选项呈灰色，这是正常机制。
• 代表用户标星需要的是用户授权的OAuth scope，而非App的仓库权限。

具体操作步骤 #

1. 配置Github App的OAuth权限
   • 进入Github App配置页，找到「OAuth permissions」板块，添加user:star权限（用于代表用户管理标星操作）。
   • 保存配置后，重新发起用户授权流程，确保新获取的AccessToken包含该scope。
2. 验证令牌权限
   • 调用GET https://api.github.com/user接口，检查返回结果中的scopes字段，确认包含user:star。
3. 重新调用标星API
   • 使用带有user:star scope的AccessToken，执行PUT https://api.github.com/user/starred/{owner}/{repo}请求，即可完成用户标星操作。

内容的提问来源于stack exchange，提问作者Matt Pengelly