向 GitHub API 发出经过身份验证的请求时,应用程序通常需要获取当前用户的仓库和组织。 在本指南中,我们将介绍如何可靠地发现这些资源。
若要与 GitHub API 交互,将使用 Octokit.rb。 可以在 platform-samples 存储库中找到此项目的完整源代码。
入门
在开始本示例之前,应阅读“身份验证基础知识”指南(如果尚未阅读)。 下面的示例假定你已注册 OAuth app,并且你的应用程序具有用户的 OAuth 标记。
发现您的应用程序能够为用户访问的仓库
用户除了拥有他们自己的个人仓库之外,可能还是其他用户和组织所拥有仓库上的协作者。 总的来说,这些存储库是用户有权访问的存储库:要么是用户具有读取或写入权限的私有存储库,要么是用户具有写入权限的公共存储库。
OAuth 作用域和组织应用程序策略决定了你的应用可以为用户访问其中哪些存储库。 使用下面的工作流程来发现这些仓库。
照常,首先需要 GitHub 的 Octokit.rb Ruby 库。 然后我们将配置 Octoberkit.rb,使其为我们自动处理分页。 有关分页的详细信息,请参阅“在 REST API 中使用分页”。
require 'octokit'
Octokit.auto_paginate = true
接下来,我们将为给定用户传递应用程序的 OAuth 标记:
# !!! DO NOT EVER USE HARD-CODED VALUES IN A REAL APP !!!
# Instead, set and test environment variables, like below.
client = Octokit::Client.new :access_token => ENV["OAUTH_ACCESS_TOKEN"]
然后,我们便可以提取应用程序可以为用户访问的存储库:
client.repositories.each do |repository|
full_name = repository[:full_name]
has_push_access = repository[:permissions][:push]
access_type = if has_push_access
"write"
else
"read-only"
end
puts "User has #{access_type} access to #{full_name}."
end
发现您的应用程序能够为用户访问的组织
应用程序可以为用户执行各种与组织相关的任务。 若要执行这些任务,应用程序需要具有足够权限的 OAuth 授权。 例如,read:org
作用域允许你列出团队,user
作用域允许你公开用户的组织成员身份。 一旦用户将其中一个或多个作用域授予您的应用程序,您就可以获取用户的组织。
与上述发现存储库的过程一样,我们首先需要 GitHub 的 Octokit.rb Ruby 库,并对其进行配置,以便为我们处理分页。 有关分页的详细信息,请参阅“在 REST API 中使用分页”。
require 'octokit'
Octokit.auto_paginate = true
接下来,我们将为给定用户传递应用程序的 OAuth 标记,以初始化 API 客户端:
# !!! DO NOT EVER USE HARD-CODED VALUES IN A REAL APP !!!
# Instead, set and test environment variables, like below.
client = Octokit::Client.new :access_token => ENV["OAUTH_ACCESS_TOKEN"]
然后,我们可以列出我们的应用程序可以为用户访问的组织:
client.organizations.each do |organization|
puts "User belongs to the #{organization[:login]} organization."
end
返回用户的所有组织成员资格
如果你从头到尾阅读了文档,你可能注意到一种允许列出用户的公共组织成员身份的 API 方法。 大多数应用程序应避免使用这种 API 方法。 此方法仅返回用户的公共组织成员身份,而不会返回其私有组织成员身份。
作为应用程序开发者,您通常希望您的应用程序被授权访问用户的所有组织。 上述工作流程恰好能满足您的要求。