Python Requests head() 方法

定义和用法

head() 方法向指定的 url 发送 HEAD 请求。

当你不需要文件的内容,而只需要状态码或 HTTP 头时,就会执行 HEAD 请求。

实例

向一张网页发起 HEAD 请求,并返回 HTTP 头:

import requests

x = requests.head('https://www.w3school.com.cn/python/demopage.php')

print(x.headers)

亲自试一试

语法

requests.head(url, args)

args 表示下面参数表中的零个或多个命名参数。例如:

requests.head(url, timeout=2.50)

参数

参数 描述
url 必需。请求的 url。
allow_redirects

可选。布尔值,用于启用/禁用重定向。

默认为 False(不允许重定向)。

auth

可选。元组,用于启用特定的 HTTP 认证。

默认为 None。

cert

可选。字符串或元组,指定证书文件或密钥。

默认为 None。

cookies

可选。包含要发送到指定 url 的 cookie 的字典。

默认为 None。

headers

可选。包含要发送到指定 url 的 HTTP 头的字典。

默认为 None。

proxies

可选。包含协议到代理 url 的字典。

默认为 None。

stream

可选。布尔值,指示响应是否应立即下载(False)或流式传输(True)。

默认为 False。

timeout

可选。数字或元组,指示客户端等待连接和/或发送响应的时间(以秒为单位)。

默认为 None,这意味着请求将持续到连接关闭。

verify

可选。布尔值或字符串,指示是否验证服务器的 TLS 证书。

默认为 True。

返回值

head() 方法返回 requests.Response 对象