我认为本文最重要的信息并不是如何使用其他人没有文档说明的 API。虽然很有趣，但是也有一些限制，而且我也不会经常这么做。更重要的一点是，任何人都可以这么访问你后端的 API！每个人都有开发者工具和网络标签，查看你传到后端的参数、修改它们都很容易。

因此如果一个人通过修改某些参数来获取其他用户的信息，这不值得提倡。我认为提供公开 API 的大部分开发者们都知道，但是我之所以再提一次，是因为每个初学者都应该了解。: )

第四步：在 Python 中发请求

现在我们知道了我们需要哪些请求头，我们可以把  curl 命令翻译进 Python 程序！这部分是相当机械化的过程，目标仅仅是用 Python 发送与 cUrl 相同的数据。

下面是代码实例。我们使用 Python 的  requests 包实现了与前面  curl 命令相同的功能。我把整个长请求分解成了元组的数组，以便看起来更简洁。

import requestsimport urllibdata = [    ('personId','101777723'), # I redacted these IDs a bit too    ('personId','117533904'),    ('personId','111526653'),    ('personId','116731406'),    ('extensionSet.extensionNames','HANGOUTS_ADDITIONAL_DATA'),    ('extensionSet.extensionNames','HANGOUTS_OFF_NETWORK_GAIA_GET'),    ('extensionSet.extensionNames','HANGOUTS_PHONE_DATA'),    ('includedProfileStates','ADMIN_BLOCKED'),    ('includedProfileStates','DELETED'),    ('includedProfileStates','PRIVATE_PROFILE'),    ('mergedPersonSourceOptions.includeAffinity','CHAT_AUTOCOMPLETE'),    ('coreIdParams.useRealtimeNotificationExpandedAcls','true'),    ('requestMask.includeField.paths','person.email'),    ('requestMask.includeField.paths','person.gender'),    ('requestMask.includeField.paths','person.in_app_reachability'),    ('requestMask.includeField.paths','person.metadata'),    ('requestMask.includeField.paths','person.name'),    ('requestMask.includeField.paths','person.phone'),    ('requestMask.includeField.paths','person.photo'),    ('requestMask.includeField.paths','person.read_only_profile_info'),    ('requestMask.includeField.paths','person.organization'),    ('requestMask.includeField.paths','person.location'),    ('requestMask.includeField.paths','person.cover_photo'),    ('requestMask.includeContainer','PROFILE'),    ('requestMask.includeContainer','DOMAIN_PROFILE'),    ('requestMask.includeContainer','CONTACT'),    ('key','REDACTED')]response = requests.post('https://people-pa.clients6.google.com/v2/people/?key=REDACTED',    headers={        'X-HTTP-Method-Override': 'GET',        'Authorization': 'SAPISIDHASH REDACTED',        'Content-Type': 'application/x-www-form-urlencoded',        'Origin': 'https://hangouts.google.com',        'Cookie': 'REDACTED',    },    data=urllib.parse.urlencode(data),)print(response.text)

我执行这个程序后正常运行 —— 输出了一堆 JSON 数据！太棒了！

你会注意到有些地方我用  REDACTED 代替了，因为如果我把原始数据列出来你就可以用我的账号来访问谷歌论坛了，这就很不好了。

运行结束！

现在我可以随意修改 Python 程序，比如传入不同的参数，或解析结果等。

我不打算用它来做其他有意思的事了，因为我压根对这个 API 没兴趣，我只是用它来阐述请求 API 的过程。

但是你确实可以对返回的一堆 JSON 做一些处理。

curlconverter 看起来很强大

有人评论说可以使用  https://curlconverter.com/ 自动把 curl 转换成 Python（和一些其他的语言！），这看起来很神奇 —— 我都是手动转的。我在这个例子里使用了它，看起来一切正常。

追踪 API 的处理过程并不容易

我不打算夸大追踪 API 处理过程的难度 —— API 的处理过程并不明显！我也不知道传给这个谷歌论坛 API 的一堆参数都是做什么的！

但是有一些参数看起来很直观，比如  requestMask.includeField.paths=person.email 可能表示“包含每个人的邮件地址”。因此我只关心我能看懂的参数，不关心看不懂的。

（理论上）适用于所有场景

可能有人质疑 —— 这个方法适用于所有场景吗？

答案是肯定的 —— 浏览器不是魔法！浏览器发送给你的服务器的所有信息都是 HTTP 请求。因此如果我复制了浏览器发送的所有的 HTTP 请求头，那么后端就会认为请求是从我的浏览器发出的，而不是用 Python 程序发出的。

当然，我们去掉了一些浏览器发送的请求头，因此理论上后端是可以识别出来请求是从浏览器还是 Python 程序发出的，但是它们通常不会检查。

这里有一些对读者的告诫 —— 一些谷歌服务的后端会通过令人难以理解（对我来说是）方式跟前端通信，因此即使理论上你可以模拟前端的请求，但实际上可能行不通。可能会遭受更多攻击的大型 API 会有更多的保护措施。

我们已经知道了如何调用没有文档说明的 API。现在我们再来聊聊可能遇到的问题。

问题 1：会话 cookie 过期

一个大问题是我用我的谷歌会话 cookie 作为身份认证，因此当我的浏览器会话过期后，这个脚本就不能用了。

这意味着这种方式不能长久使用（我宁愿调一个真正的 API），但是如果我只是要一次性快速抓取一小组数据，那么可以使用它。

问题 2：滥用

如果我正在请求一个小网站，那么我的 Python 脚本可能会把服务打垮，因为请求数超出了它们的处理能力。因此我请求时尽量谨慎，尽量不过快地发送大量请求。

这尤其重要，因为没有官方 API 的网站往往是些小网站且没有足够的资源。

很明显在这个例子中这不是问题 —— 我认为在写这篇文章的过程我一共向谷歌论坛的后端发送了 20 次请求，他们肯定可以处理。

如果你用自己的账号身份过度访问这个 API 并导致了故障，那么你的账号可能会被暂时封禁（情理之中）。

我只下载我自己的数据或公共的数据 —— 我的目的不是寻找网站的弱点。