mirror of
https://github.com/LCTT/TranslateProject.git
synced 2025-02-28 01:01:09 +08:00
TSL
This commit is contained in:
Xiaobin.Liu
parent
7fb5fadb66
commit
35ec0e5c22
@ -1,233 +0,0 @@
|
||||
[#]: subject: "How to use undocumented web APIs"
|
||||
[#]: via: "https://jvns.ca/blog/2022/03/10/how-to-use-undocumented-web-apis/"
|
||||
[#]: author: "Julia Evans https://jvns.ca/"
|
||||
[#]: collector: "lujun9972"
|
||||
[#]: translator: "lxbwolf"
|
||||
[#]: reviewer: " "
|
||||
[#]: publisher: " "
|
||||
[#]: url: " "
|
||||
|
||||
How to use undocumented web APIs
|
||||
======
|
||||
|
||||
Hello! A couple of days I wrote about [tiny personal programs][1], and I mentioned that it can be fun to use “secret” undocumented APIs where you need to copy your cookies out of the browser to get access to them.
|
||||
|
||||
A couple of people asked how to do this, so I wanted to explain how because it’s pretty straightforward. We’ll also talk a tiny bit about what can go wrong, ethical issues, and how this applies to your undocumented APIs.
|
||||
|
||||
As an example, let’s use Google Hangouts. I’m picking this not because it’s the most useful example (I think there’s an official API which would be much more practical to use), but because many sites where this is actually useful are smaller sites that are more vulnerable to abuse. So we’re just going to use Google Hangouts because I’m 100% sure that the Google Hangouts backend is designed to be resilient to this kind of poking around.
|
||||
|
||||
Let’s get started!
|
||||
|
||||
### step 1: look in developer tools for a promising JSON response
|
||||
|
||||
I start out by going to <https://hangouts.google.com>, opening the network tab in Firefox developer tools and looking for JSON responses. You can use Chrome developer tools too.
|
||||
|
||||
Here’s what that looks like
|
||||
|
||||
![][2]
|
||||
|
||||
The request is a good candidate if it says “json” in the “Type” column”
|
||||
|
||||
I had to look around for a while until I found something interesting, but eventually I found a “people” endpoint that seems to return information about my contacts. Sounds fun, let’s take a look at that.
|
||||
|
||||
### step 2: copy as cURL
|
||||
|
||||
Next, I right click on the request I’m interested in, and click “Copy” -> “Copy as cURL”.
|
||||
|
||||
Then I paste the `curl` command in my terminal and run it. Here’s what happens.
|
||||
|
||||
```
|
||||
|
||||
$ curl 'https://people-pa.clients6.google.com/v2/people/?key=REDACTED' -X POST ........ (a bunch of headers removed)
|
||||
Warning: Binary output can mess up your terminal. Use "--output -" to tell
|
||||
Warning: curl to output it to your terminal anyway, or consider "--output
|
||||
Warning: <FILE>" to save to a file.
|
||||
|
||||
```
|
||||
|
||||
You might be thinking – that’s weird, what’s this “binary output can mess up your terminal” error? That’s because by default, browsers send an `Accept-Encoding: gzip, deflate` header to the server, to get compressed output.
|
||||
|
||||
We could decompress it by piping the output to `gunzip`, but I find it simpler to just not send that header. So let’s remove some irrelevant headers.
|
||||
|
||||
### step 3: remove irrelevant headers
|
||||
|
||||
Here’s the full `curl` command line that I got from the browser. There’s a lot here! I start out by splitting up the request with backslashes (`\`) so that each header is on a different line to make it easier to work with:
|
||||
|
||||
```
|
||||
|
||||
curl 'https://people-pa.clients6.google.com/v2/people/?key=REDACTED' \
|
||||
-X POST \
|
||||
-H 'User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:96.0) Gecko/20100101 Firefox/96.0' \
|
||||
-H 'Accept: */*' \
|
||||
-H 'Accept-Language: en' \
|
||||
-H 'Accept-Encoding: gzip, deflate' \
|
||||
-H 'X-HTTP-Method-Override: GET' \
|
||||
-H 'Authorization: SAPISIDHASH REDACTED' \
|
||||
-H 'Cookie: REDACTED'
|
||||
-H 'Content-Type: application/x-www-form-urlencoded' \
|
||||
-H 'X-Goog-AuthUser: 0' \
|
||||
-H 'Origin: https://hangouts.google.com' \
|
||||
-H 'Connection: keep-alive' \
|
||||
-H 'Referer: https://hangouts.google.com/' \
|
||||
-H 'Sec-Fetch-Dest: empty' \
|
||||
-H 'Sec-Fetch-Mode: cors' \
|
||||
-H 'Sec-Fetch-Site: same-site' \
|
||||
-H 'Sec-GPC: 1' \
|
||||
-H 'DNT: 1' \
|
||||
-H 'Pragma: no-cache' \
|
||||
-H 'Cache-Control: no-cache' \
|
||||
-H 'TE: trailers' \
|
||||
--data-raw 'personId=101777723309&personId=1175339043204&personId=1115266537043&personId=116731406166&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'
|
||||
|
||||
```
|
||||
|
||||
This can seem like an overwhelming amount of stuff at first, but you don’t need to think about what any of it means at this stage. You just need to delete irrelevant lines.
|
||||
|
||||
I usually just figure out which headers I can delete with trial and error – I keep removing headers until the request starts failing. In general you probably don’t need `Accept*`, `Referer`, `Sec-*`, `DNT`, `User-Agent`, and caching headers though.
|
||||
|
||||
In this example, I was able to cut the request down to this:
|
||||
|
||||
```
|
||||
|
||||
curl 'https://people-pa.clients6.google.com/v2/people/?key=REDACTED' \
|
||||
-X POST \
|
||||
-H 'Authorization: SAPISIDHASH REDACTED' \
|
||||
-H 'Content-Type: application/x-www-form-urlencoded' \
|
||||
-H 'Origin: https://hangouts.google.com' \
|
||||
-H 'Cookie: REDACTED'\
|
||||
--data-raw 'personId=101777723309&personId=1175339043204&personId=1115266537043&personId=116731406166&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'
|
||||
|
||||
```
|
||||
|
||||
So I just need 4 headers: `Authorization`, `Content-Type`, `Origin`, and `Cookie`. That’s a lot more manageable.
|
||||
|
||||
### step 4: translate it into Python
|
||||
|
||||
Now that we know what headers we need, we can translate our `curl` command into a Python program! This part is also a pretty mechanical process, the goal is just to send exactly the same data with Python as we were with curl.
|
||||
|
||||
Here’s what that looks like. This is exactly the same as the previous `curl` command, but using Python’s `requests`. I also broke up the very long request body string into an array of tuples to make it easier to work with programmmatically.
|
||||
|
||||
```
|
||||
|
||||
import requests
|
||||
import urllib
|
||||
|
||||
data = [
|
||||
('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)
|
||||
|
||||
```
|
||||
|
||||
I ran this program and it works – it prints out a bunch of JSON! Hooray!
|
||||
|
||||
You’ll notice that I replaced a bunch of things with `REDACTED`, that’s because if I included those values you could access the Google Hangouts API for my account which would be no good.
|
||||
|
||||
### and we’re done!
|
||||
|
||||
Now I can modify the Python program to do whatever I want, like passing different parameters or parsing the output.
|
||||
|
||||
I’m not going to do anything interesting with it because I’m not actually interested in using this API at all, I just wanted to show what the process looks like.
|
||||
|
||||
But we get back a bunch of JSON that you could definitely do something with.
|
||||
|
||||
### curlconverter looks great
|
||||
|
||||
Someone commented that you can translate curl to Python (and a bunch of other languages!) automatically with <https://curlconverter.com/> which looks amazing – I’ve always done it manually. I tried it out on this example and it seems to work great.
|
||||
|
||||
### figuring out how the API works is nontrivial
|
||||
|
||||
I don’t want to undersell how difficult it can be to figure out how an unknown API works – it’s not obvious! I have no idea what a lot of the parameters to this Google Hangouts API do!
|
||||
|
||||
But a lot of the time there are some parameters that seem pretty straightforward, like `requestMask.includeField.paths=person.email` probably means “include each person’s email address”. So I try to focus on the parameters I _do_ understand more than the ones I _don’t_ understand.
|
||||
|
||||
### this always works (in theory)
|
||||
|
||||
Some of you might be wondering – can you always do this?
|
||||
|
||||
The answer is sort of yes – browsers aren’t magic! All the information browsers send to your backend is just HTTP requests. So if I copy all of the HTTP headers that my browser is sending, I think there’s literally no way for the backend to tell that the request _isn’t_ sent by my browser and is actually being sent by a random Python program.
|
||||
|
||||
Of course, we removed a bunch of the headers the browser sent so theoretically the backend _could_ tell, but usually they won’t check.
|
||||
|
||||
There are some caveats though – for example a lot of Google services have backends that communicate with the frontend in a totally inscrutable (to me) way, so even though in theory you could mimic what they’re doing, in practice it might be almost impossible. And bigger APIs that encounter more abuse will have more protections.
|
||||
|
||||
Now that we’ve seen how to use undocumented APIs like this, let’s talk about some things that can go wrong.
|
||||
|
||||
### problem 1: expiring session cookies
|
||||
|
||||
One big problem here is that I’m using my Google session cookie for authentication, so this script will stop working whenever my browser session expires.
|
||||
|
||||
That means that this approach wouldn’t work for a long running program (I’d want to use a real API), but if I just need to quickly grab a little bit of data as a 1-time thing, it can work great!
|
||||
|
||||
### problem 2: abuse
|
||||
|
||||
If I’m using a small website, there’s a chance that my little Python script could take down their service because it’s doing way more requests than they’re able to handle. So when I’m doing this I try to be respectful and not make too many requests too quickly.
|
||||
|
||||
This is especially important because a lot of sites which don’t have official APIs are smaller sites with less resources.
|
||||
|
||||
In this example obviously this isn’t a problem – I think I made 20 requests total to the Google Hangouts backend while writing this blog post, which they can definitely handle.
|
||||
|
||||
Also if you’re using your account credentials to access the API in a excessive way and you cause problems, you might (very reasonably) get your account suspended.
|
||||
|
||||
I also stick to downloading data that’s either mine or that’s intended to be publicly accessible – I’m not searching for vulnerabilities.
|
||||
|
||||
### remember that anyone can use your undocumented APIs
|
||||
|
||||
I think the most important thing to know about this isn’t actually how to use _other people’s_ undocumented APIs. It’s fun to do, but it has a lot of limitations and I don’t actually do it that often.
|
||||
|
||||
It’s much more important to understand that anyone can do this to _your_ backend API! Everyone has developer tools and the network tab, and it’s pretty easy to see which parameters you’re passing to the backend and to change them.
|
||||
|
||||
So if anyone can just change some parameters to get another user’s information, that’s no good. I think most developers building publicly availble APIs know this, but I’m mentioning it because everyone needs to learn it for the first time at some point :)
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://jvns.ca/blog/2022/03/10/how-to-use-undocumented-web-apis/
|
||||
|
||||
作者：[Julia Evans][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[译者ID](https://github.com/译者ID)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://jvns.ca/
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://jvns.ca/blog/2022/03/08/tiny-programs/
|
||||
[2]: https://jvns.ca/images/network-tab.png
|
||||
233
translated/tech/20220310 How to use undocumented web APIs.md
Normal file
233
translated/tech/20220310 How to use undocumented web APIs.md
Normal file
@ -0,0 +1,233 @@
|
||||
[#]: subject: "How to use undocumented web APIs"
|
||||
[#]: via: "https://jvns.ca/blog/2022/03/10/how-to-use-undocumented-web-apis/"
|
||||
[#]: author: "Julia Evans https://jvns.ca/"
|
||||
[#]: collector: "lujun9972"
|
||||
[#]: translator: "lxbwolf"
|
||||
[#]: reviewer: " "
|
||||
[#]: publisher: " "
|
||||
[#]: url: " "
|
||||
|
||||
如何调用没有文档说明的 web API
|
||||
======
|
||||
|
||||
大家好！几天前我写了篇[个人 demo 小程序][1]，里面提到了调用没有文档说明的“私有” API 很有意思，你需要从你的浏览器中把 cookies 复制出来才能访问。
|
||||
|
||||
有些读者问如何实现，因此我打算详细描述下，其实过程很简单。我们还会涉及一点点在调用没有文档说明的 API 时，可能会遇到的麻烦。
|
||||
|
||||
我们用谷歌论坛举例。我之所以选择它，不是因为这个例子最有用（我认为官方的 API 更有实践意义）,而是因为在这个场景中更有用的网站很多是小网站，而小网站的 API 一旦被滥用，受到的伤害会更大。因此我们使用谷歌论坛，因为我 100% 肯定谷歌论坛对于这种试探请求可以很快恢复。
|
||||
|
||||
我们现在开始！
|
||||
|
||||
### 第一步：打开开发者工具，找一个 JSON 响应
|
||||
|
||||
我浏览了<https://hangouts.google.com>，在 Firefox 的开发者工具中打开网络标签，找到一个 JSON 响应。你也可以使用 Chrome 的开发者工具。
|
||||
|
||||
打开之后界面如下图
|
||||
|
||||
![][2]
|
||||
|
||||
找到其中一条 “Type” 列显示为 ”json“ 的请求。
|
||||
|
||||
为了找一条感兴趣的请求，我找了好一会儿，突然我找到一条 ”people“ 的 endpoint，看起来是返回我们的联系人信息。听起来很有意思，我们来看一下。
|
||||
|
||||
### 第二步：复制为 cURL
|
||||
|
||||
下一步，我在感兴趣的请求上右键，点击 ”复制“ -> ”复制为 cURL“。
|
||||
|
||||
然后我把 `curl` 命令粘贴到终端并运行。下面是运行结果：
|
||||
|
||||
```
|
||||
|
||||
$ curl 'https://people-pa.clients6.google.com/v2/people/?key=REDACTED' -X POST ........ (a bunch of headers removed)
|
||||
Warning: Binary output can mess up your terminal. Use "--output -" to tell
|
||||
Warning: curl to output it to your terminal anyway, or consider "--output
|
||||
Warning: <FILE>" to save to a file.
|
||||
|
||||
```
|
||||
|
||||
你可能会想 —— 很奇怪，”二进制的输出在你的终端上无法正常显示“ 是什么错误？原因是，浏览器默认情况下发给服务器的请求头中有 `Accept-Encoding: gzip, deflate` 参数，会把输出结果进行压缩。
|
||||
|
||||
我们可以通过管道把输出传递给 `gunzip` 来解压，但是我们发现不带这个参数进行请求会更简单。因此我们去掉一些不相关的请求头。
|
||||
|
||||
### 第三步：去掉不相关的请求头
|
||||
|
||||
下面是我从浏览器获得的完整 `curl` 命令。有很多行！我用反斜杠（`\`）把请求分开，这样每个请求头占一行，看起来更清晰。
|
||||
|
||||
```
|
||||
|
||||
curl 'https://people-pa.clients6.google.com/v2/people/?key=REDACTED' \
|
||||
-X POST \
|
||||
-H 'User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:96.0) Gecko/20100101 Firefox/96.0' \
|
||||
-H 'Accept: */*' \
|
||||
-H 'Accept-Language: en' \
|
||||
-H 'Accept-Encoding: gzip, deflate' \
|
||||
-H 'X-HTTP-Method-Override: GET' \
|
||||
-H 'Authorization: SAPISIDHASH REDACTED' \
|
||||
-H 'Cookie: REDACTED'
|
||||
-H 'Content-Type: application/x-www-form-urlencoded' \
|
||||
-H 'X-Goog-AuthUser: 0' \
|
||||
-H 'Origin: https://hangouts.google.com' \
|
||||
-H 'Connection: keep-alive' \
|
||||
-H 'Referer: https://hangouts.google.com/' \
|
||||
-H 'Sec-Fetch-Dest: empty' \
|
||||
-H 'Sec-Fetch-Mode: cors' \
|
||||
-H 'Sec-Fetch-Site: same-site' \
|
||||
-H 'Sec-GPC: 1' \
|
||||
-H 'DNT: 1' \
|
||||
-H 'Pragma: no-cache' \
|
||||
-H 'Cache-Control: no-cache' \
|
||||
-H 'TE: trailers' \
|
||||
--data-raw 'personId=101777723309&personId=1175339043204&personId=1115266537043&personId=116731406166&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'
|
||||
|
||||
```
|
||||
|
||||
第一眼看起来内容有很多，但是现在你不需要考虑每一行是什么意思。你只需要把不相关的行删掉就可以了。
|
||||
|
||||
我通常通过删掉某行查看是否有错误来验证该行是不是可以删除 —— 只要请求没有错误就一直删请求头。通常情况下，你可以删掉 `Accept*`、`Referer`、`Sec-*`、`DNT`、`User-Agent` 和缓存相关的头。
|
||||
|
||||
在这个例子中，我把请求删成下面的样子：
|
||||
|
||||
```
|
||||
|
||||
curl 'https://people-pa.clients6.google.com/v2/people/?key=REDACTED' \
|
||||
-X POST \
|
||||
-H 'Authorization: SAPISIDHASH REDACTED' \
|
||||
-H 'Content-Type: application/x-www-form-urlencoded' \
|
||||
-H 'Origin: https://hangouts.google.com' \
|
||||
-H 'Cookie: REDACTED'\
|
||||
--data-raw 'personId=101777723309&personId=1175339043204&personId=1115266537043&personId=116731406166&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'
|
||||
|
||||
```
|
||||
|
||||
这样我只需要 4 个请求头：`Authorization`、`Content-Type`、`Origin` 和 `Cookie`。这样容易管理得多。
|
||||
|
||||
### 第四步：在 Python 中发请求
|
||||
|
||||
现在我们知道了我们需要哪些请求头，我们可以把 `curl` 命令翻译进 Python 程序！这部分是相当机械化的过程，目标仅仅是用 Python 发送与 curl 相同的数据。
|
||||
|
||||
下面是代码实例。我们使用 Python 的 `requests` 包实现了与前面 `curl` 命令相同的功能。我把整个长请求分解成了元组的数组，以便看起来更简洁。
|
||||
|
||||
```
|
||||
|
||||
import requests
|
||||
import urllib
|
||||
|
||||
data = [
|
||||
('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：session cookies 过期
|
||||
|
||||
一个大问题是我用我的谷歌 session cookie 作为身份认证，因此当我的浏览器 session 过期后，这个脚本就不能用了。
|
||||
|
||||
这意味着这种方式不能长久使用（我宁愿调一个真正的 API），但是如果我只是要一次性快速抓取一小组数据，那么可以使用它。
|
||||
|
||||
### 问题 2：滥用
|
||||
|
||||
如果我正在请求一个小网站，那么我的 Python 脚本可能会把服务打垮，因为请求数超出了它们的处理能力。因此我请求时尽量谨慎，尽量不过快地发送大量请求。
|
||||
|
||||
这尤其重要，因为没有官方 API 的网站往往是些小网站且没有足够的资源。
|
||||
|
||||
很明显在这个例子中这不是问题 —— 我认为在写这篇文章的过程我一共向谷歌论坛的后端发送了 20 次请求，他们肯定可以处理。
|
||||
|
||||
如果你用自己的账号资格过度访问这个 API 并导致了故障，那么你的账号可能（情理之中）会被暂时封禁。
|
||||
|
||||
我只下载我自己的数据或公共的数据 —— 我的目的不是寻找网站的弱点。
|
||||
|
||||
### 请记住所有人都可以访问你没有文档说明的 API
|
||||
|
||||
我认为本文最重要的信息并不是如何使用其他人没有文档说明的 API。虽然很有趣，但是也有一些限制，而且我也不会经常这么做。
|
||||
|
||||
更重要的一点是，任何人都可以这么访问你后端的 API！每个人都有开发者工具和网络标签，查看你传到后端的参数、修改它们都很容易。
|
||||
|
||||
因此如果一个人通过修改某些参数来获取其他用户的信息，这不值得提倡。我认为提供公开 API 的大部分开发者们都知道，但是我之所以再提一次，是因为每个初学者都应该了解。:)
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://jvns.ca/blog/2022/03/10/how-to-use-undocumented-web-apis/
|
||||
|
||||
作者：[Julia Evans][a]
|
||||
选题：[lujun9972][b]
|
||||
译者：[lxbwolf](https://github.com/lxbwolf)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]: https://jvns.ca/
|
||||
[b]: https://github.com/lujun9972
|
||||
[1]: https://jvns.ca/blog/2022/03/08/tiny-programs/
|
||||
[2]: https://jvns.ca/images/network-tab.png
|
||||
Loading…
Reference in New Issue
Block a user