转载

GitHub推出预览版组织成员APIs

　　英文原文：GitHub New Organization Membership APIs Now in Preview

　　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 头中自定义媒体类型：