1. 引言
FastAPI是Python中非常流行的Web框架之一，它支持异步请求处理、简单易用、可维护性强等优点，而外部服务则是构建任何现代应用程序不可或缺的一部分。在这篇文章中，我们将学习如何结合FastAPI和外部服务进行第三方集成。我们将使用GitHub API作为示例，以展示在FastAPI中使用API的步骤和最佳实践。
2. 获取GitHub Personal Access Token
在使用GitHub API之前，我们需要生成一个Personal Access Token。Personal Access Token作为OAuth授权的一种方式，可以用于访问GitHub API。在进行OAuth授权之前，我们需要登录我们的GitHub帐户并创建一个Personal Access Token。具体步骤如下：
2.1 登录GitHub账户
首先，我们需要登录我们的GitHub账户。如果您还没有GitHub账户，请在官网上创建一个免费的账户。
2.2 创建Personal Access Token
登录后，转到Settings->Developer settings->Personal access tokens页面，单击“生成新令牌”按钮。
在弹出的窗口中，选择令牌的权限并单击“生成令牌”按钮。然后，系统将在页面上显示Personal Access Token。请将该Token复制并保存到安全的位置，以便后续使用。
3. 使用GitHub API
我们现在已经拥有了Personal Access Token，让我们开始构建使用GitHub API的FastAPI应用程序。首先，我们需要安装“requests”库，它是Python中最常用的库之一，用于发送HTTP请求。
pip install requests接下来，我们可以编写我们的FastAPI应用程序，并在其中使用GitHub API。以下是示例代码：
from fastapi import FastAPI
import requests
app = FastAPI()
@app.get("/repos/{owner}/{repo}/contributors")
async def get_contributors(owner: str, repo: str):
headers = {"Authorization": "Token YOUR_TOKEN_HERE"}
url = f"https://api.github.com/repos/{owner}/{repo}/contributors"
response = requests.get(url, headers=headers)
return response.json()
上面的代码定义了一个GET类型的路由，该路由将返回指定github仓库的贡献者列表，路由的参数为所有者和仓库名称。请注意，我们在GET方法路由中传递了两个参数：所有者(str类型)和存储库(str类型)。这将返回一个JSON形式的响应，其中包含贡献者的详细信息。为了使用GitHub API，我们需要使用Personal Access Token对请求进行OAuth2认证。因此，我们在headers中包含Authorization头。请将YOUR_TOKEN_HERE替换为您的Personal Access Token。
在代码中，我们使用了“requests”库来执行HTTP GET请求，并将响应转换为JSON对象。GET请求的URL是https://api.github.com/repos/{owner}/{repo}/contributors，该URL将返回指定存储库的贡献者列表。
4. 测试
我们已经完成了代码的编写，并在其中使用了GitHub API。是时候测试我们的代码了。我们可以使用curl进行测试。以下是一个示例curl命令，向上述定义的路由发送GET请求：
curl http://localhost:8000/repos/octocat/Hello-World/contributors这将返回一个JSON数组，其中包含所有贡献者的详细信息。
5. 结论
在这篇文章中，我们学习了如何在FastAPI中使用GitHub API，以及如何在使用API时使用Personal Access Token进行OAuth2认证。我们还学习了如何使用Python中的“requests”库发送HTTP请求，以及如何将响应转换为JSON对象。通过使用GitHub API，我们可以轻松地获取存储库、贡献者、问题和拉取请求等信息，这为我们的应用程序提供了无限的可能性。