如何通过邮箱ID调用Octokit/GitHub API邀请成员加入仓库团队

Octokit 提供的AddOrEditMembership(id, name, role)方法仅支持通过GitHub用户名直接添加成员，不支持传入邮箱ID发送邀请。要实现基于邮箱发送组织仓库团队邀请的需求，可以调用Octokit封装的团队邀请接口，对应底层GitHub原生API原生支持邮箱邀请能力。

Octokit全语言官方维护版本（JS/C#/Ruby等）都提供了CreateInvitation方法对应邮箱邀请能力，该方法同时支持按GitHub用户名、按邮箱两种邀请模式：

• 传入用户名时，会直接向对应已注册GitHub账号发送团队加入通知
• 传入邮箱时，会向目标邮箱发送邀请邮件，收件人点击邮件链接完成GitHub登录/注册后，会自动加入对应团队，不需要提前获取对方的GitHub账号ID

调用示例（以JS版Octokit为例）：

// 初始化具备组织管理员权限的客户端
const octokit = new Octokit({ auth: "你的GitHub访问Token" });

// 执行邮箱邀请
await octokit.rest.teams.createInvitation({
  org: "目标组织名称",
  team_slug: "目标仓库对应团队的路径标识",
  email: "被邀请人邮箱ID",
  role: "member" // 可配置为member（普通成员）或maintainer（团队维护者）
});

注意事项：

1. 调用接口使用的Token需要持有admin:org权限，否则会返回权限不足错误
2. 如果目标组织开启了「仅允许邀请已知平台用户」的安全策略，邮箱邀请接口会被拦截，需要先在组织设置中调整对应安全配置

• AddOrEditMembership属于直接成员管理接口，调用成功后用户会直接成为团队成员，不会走邀请确认流程，仅支持传入已存在的GitHub用户名
• CreateInvitation属于邀请流程接口，需要收件人确认后才会生效，同时支持用户名、邮箱两种入参，完全匹配基于邮箱发邀请的需求

内容的提问来源于stack exchange，提问作者Siva Valeti