GitHub推出了新的API端点以更好地管理其平台上的组织。新的Outside Collaborators API将支持远程管理访问权限并进行用户管理。
\\即使不是组织的一员,GitHub中定义的外部合作者仍然拥有读、写或管理该组织中一些仓库的权限。外部合作者往往是顾问,或是临时雇员,他们虽然没有正式成员的所有权限,但是享有对具体仓库操作的一些权限。
\\新的Outside Collaborators API可以帮助实现:
\\- 列出外部合作者\\t
- 删除外部合作者\\t
- 将一名成员转换为外部合作者\
Outside Collaborators API是组织API的一部分,它包含四个主要端点:组织、成员、团队和webhooks。其中,成员和组织端点已经进行了扩展,可以更好地与新的Outside Collaborators API集成。尤其是:
\\同时,作为仓库API的一员,collaborators API允许审查用户的权限级别。
\\此外,部分现有的端点为了能和新的组织端点更好地集成,增加了以下新功能:
\\- 当获取或编辑组织的时候,可以检索和设置两个新的组织级别设置选项:default_repository_permission以及members_can_create_repositories\\t
- create team端点现在支持maintainers参数,帮助添加新的团队维护者\\t
- list collaborators端点现在支持affiliation参数,通过关联类型过滤仓库的合作者。\
所有新的或经过修改的端点都需要在Accept头中自定义媒体类型:
\\\application/vnd.github.korra-preview+json\
\\
由于新的APIs仍处于预览状态,根据开发者的反馈GitHub将会随时对它进行改动。
\\查看英文原文:GitHub New Organization Membership APIs Now in Preview