7.5 KiB

Raw Permalink Blame History

在 Python 中使用请求库

原文：https://www.pythonforbeginners.com/requests/using-requests-in-python

首先，让我们向您介绍请求。

什么是请求资源？

Requests 是一个 Apache2 许可的 HTTP 库，用 Python 编写。它被设计成供人类用来与语言互动。这意味着您不必手动向 URL 添加查询字符串，或者对您的帖子数据进行格式编码。如果这对你来说没有意义，不要担心。它会在适当的时候。

请求能做什么？

请求将允许您使用 Python 发送 HTTP/1.1 请求。有了它，您可以通过简单的 Python 库添加内容，如标题、表单数据、多部分文件和参数。它还允许您以同样的方式访问 Python 的响应数据。

在编程中，库是程序可以使用的例程、函数和操作的集合或预先配置的选择。这些元素通常被称为模块，并以对象格式存储。

库很重要，因为你加载一个模块并利用它提供的一切，而不用显式地链接到依赖它们的每个程序。它们是真正独立的，所以你可以用它们来构建你自己的程序，但它们仍然是独立于其他程序的。

把模块想象成一种代码模板。

重申一下，Requests 是一个 Python 库。

如何安装请求

好消息是有几种方法可以安装请求库。要查看可供您选择的选项的完整列表，您可以在此查看请求的官方安装文档。

您可以使用 pip、easy_install 或 tarball。

如果你更喜欢使用源代码，你也可以在 GitHub 上找到。

出于本指南的目的，我们将使用 pip 来安装库。

在 Python 解释器中，输入以下内容:

*pip install requests*

导入请求模块

要使用 Python 中的请求库，必须导入适当的模块。只需在脚本的开头添加以下代码，就可以做到这一点:

*import requests*

当然，要做到这些——包括安装库——您需要首先下载必要的包，并让解释器可以访问它。

提出请求

当您 ping 一个网站或门户网站以获取信息时，这被称为发出请求。这正是请求库的设计目的。

要获得一个网页，你需要做如下事情:

*r =* *requests.get**(‘https://github.com/**timeline.json**’)*

使用响应代码

在使用 Python 对网站或 URL 进行任何操作之前，最好检查一下所述门户的当前状态代码。您可以使用字典查找对象来实现这一点。

*r =* *requests.get**('https://github.com/**timeline.json**')*
*r.status**_code*
*>>200*

*r.status**_code* *==* *requests.codes.ok*
*>>> True*

*requests.codes**['**temporary_redirect**']*
*>>> 307*

*requests.codes**.teapot*
*>>> 418*

*requests.codes**['o/']*
*>>> 200*

获取内容

在 web 服务器返回响应后，您可以收集您需要的内容。这也是使用 get requests 函数完成的。

*import requests*
*r =* *requests.get**('https://github.com/**timeline.json**')*
*print* *r.text*

*#* *The* *Requests* *library* *also comes with a built**-**in JSON decoder,*
*#* *just* *in case* *you have to deal* *with JSON data*

*import requests*
*r =* *requests.get**('https://github.com/**timeline.json**')*
*print* *r.json*

使用标题

通过使用 Python 字典，您可以访问和查看服务器的响应头。由于 Requests 的工作方式，您可以使用任何大小写来访问标题。

如果您执行了这个函数，但是响应中不存在标题，那么这个值将默认为 None。

*r.headers*
*{*
*    'status': '200 OK',*
*    'content-encoding': '**gzip**',*
*    'transfer-encoding': 'chunked',*
*    'connection': 'close',*
*    'server': '**nginx**/1.0.4',*
*    'x-runtime': '148ms',*
*    '**etag**': '"e1ca502697e5c9317743dc078f67693f"',*
*    'content-type': 'application/**json**; charset=utf-8'*
*}*

*r.headers**['Content-Type']*
*>>>'application/**json**; charset=utf-8'*

*r.headers.get**('content-type')*
*>>>'application/**json**; charset=utf-8'*

*r.headers**['X-Random']*
*>>>None*

*# Get the headers of a given URL*
*resp* *=* *requests.head**("http://www.google.com")*
*print* *resp.status**_code**,* *resp.text**,* *resp.headers*

编码

请求将自动十年从服务器拉任何内容。但是大多数 Unicode 字符集无论如何都是无缝解码的。

当您向服务器发出请求时，请求库会根据 HTTP 头对响应的编码进行有根据的猜测。当您访问 r.text 文件时，将使用猜测的编码。

通过这个文件，您可以辨别请求库使用的是什么编码，并在需要时进行更改。这是可能的，因为您将在文件中找到的 r.encoding 属性。

如果您更改编码值，只要您在代码中调用 r.text，请求就会使用新的类型。

*print* *r.encoding*
*>> utf-8*

*>>>* *r.encoding* *= ‘ISO-8859-1’*

自定义标题

如果要向请求添加自定义 HTTP 头，必须通过字典将它们传递给 headers 参数。

*import* *json*
*url* *= 'https://api.github.com/some/endpoint'*
*payload = {'some': 'data'}*
*headers = {'content-type': 'application/**json**'}*

*r =* *requests.post**(**url**, data=**json.dumps**(payload), headers=headers)*

重定向和历史记录

当您在 Python 中使用 GET 和 OPTIONS 谓词时，请求将自动执行位置重定向。

GitHub 会自动将所有 HTTP 请求重定向到 HTTPS。这保证了东西的安全和加密。

您可以使用 response 对象的 history 方法来跟踪重定向状态。

*r =* *requests.get**('http://github.com')*
*r.url*
*>>> 'https://github.com/'*

*r.status**_code*
*>>> 200*

*r.history* 
*>>> []*

发出 HTTP Post 请求

您还可以使用请求库来处理 post 请求。

*r =* *requests.post**(http://httpbin.org/post)*

但是你也可以依赖其他 HTTP 请求，比如 PUT ， DELETE ， HEAD ，以及 OPTIONS 。

*r =* *requests.put**("http://httpbin.org/put")*
*r =* *requests.delete**("http://httpbin.org/delete")*
*r =* *requests.head**("http://httpbin.org/get")*
*r =* *requests.options**("http://httpbin.org/get")*

你可以用这些方法来完成很多事情。例如，使用 Python 脚本创建 GitHub repo。

*import requests,* *json*

*github_url* *= "https://api.github.com/user/repos"*
*data =* *json.dumps**({'**name':'test**', '**description':'some* *test repo'})*
*r =* *requests.post**(**github_url**, data,* *auth**=('user', '*****'))*

*print* *r.json*