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
评论