GitHub 推出预览版组织成员 APIs

  • Sergio De Simone
  • 刘嘉洋

2016 年 12 月 8 日

话题:GitHub语言 & 开发

GitHub推出了新的 API 端点以更好地管理其平台上的组织。新的 Outside Collaborators API 将支持远程管理访问权限并进行用户管理。

即使不是组织的一员,GitHub 中定义的外部合作者仍然拥有读、写或管理该组织中一些仓库的权限。外部合作者往往是顾问,或是临时雇员,他们虽然没有正式成员的所有权限,但是享有对具体仓库操作的一些权限。

新的Outside Collaborators API可以帮助实现:

Outside Collaborators API 是组织 API的一部分,它包含四个主要端点:组织成员团队webhooks。其中,成员和组织端点已经进行了扩展,可以更好地与新的 Outside Collaborators API 集成。尤其是:

同时,作为仓库API 的一员,collaborators API 允许审查用户的权限级别

此外,部分现有的端点为了能和新的组织端点更好地集成,增加了以下新功能:

  • 获取编辑组织的时候,可以检索和设置两个新的组织级别设置选项:default_repository_permission 以及 members_can_create_repositories
  • create team端点现在支持 maintainers 参数,帮助添加新的团队维护者
  • list collaborators端点现在支持 affiliation 参数,通过关联类型过滤仓库的合作者。

所有新的或经过修改的端点都需要在 Accept 头中自定义媒体类型:

application/vnd.github.korra-preview+json

由于新的 APIs 仍处于预览状态,根据开发者的反馈 GitHub 将会随时对它进行改动。

查看英文原文GitHub New Organization Membership APIs Now in Preview

GitHub语言 & 开发