[module] Python - requests.head() 메서드 - 지정 URL에 HEAD 요청 보냄. (= head메서드 = 헤드)

목차

1. requests.head() 예제
2. requests.head() 정의
3. requests.head() 구문
4. requests.head() 매개변수

 

import requests

x = requests.head('https://homzzang.com/python/demo.php')

print(x.status_code)

print(x.text)

 

requests.head() 정의

 

지정 URL에 HEAD 요청 보냄.

 

※ HEAD 요청은 "파일 내용 필요하지 않으나 status_code 또는 HTTP 헤더만 필요"할 때 수행.

 

requests.head() 구문

 

requests.head(url, args)

 

---

[매개변수]

 

url

필수. 요청 url 주소

 

args

선택. 아래 매개변수 중  0개 이상 사용 가능.

 

---

[반환값]

 

requests.Response 객체 반환.

 

requests.head() 매개변수

url 

필수. 요청 URL

 

(예제)

import requests

url = 'https://homzzang.com/python/demo.php'

x = requests.head(url)

 

print(x.headers)

 

---

allow_redirects 

선택. 리디렉션 허용 여부 선택하는 Boolean.

※ True : 허용. (기본값)

※ False : 비허용. 

 

(예제1)

import requests

url = 'https://homzzang.com/python/demo.php'

x = requests.head(url, allow_redirects=True)

print(x.status_code) # 200 (요청 성공)

 

(예제2)

import requests

url = 'https://homzzang.com/python/demo.php'

x = requests.head(url)

print(x.status_code) # 301 (주소 바뀜)

 

---

auth

선택. 특정 HTTP 인증을 활성화하는 Tuple.

※ 기본값: None

 

(예제)

import requests

url = 'https://homzzang.com/python/demo.php'

# HTTP 기본 인증으로 요청 보냄.

x = requests.head(url, auth = ('user', 'pass')) 

print(x.status_code) # 200 (※ 통신 성공 의미.)

 

---

cert

선택. 인증서 파일 또는 키를 지정하는 String 또는 Tuple.

※ 기본값: None

 

(예제)

import requests

url = 'https://homzzang.com/python/demo.php'

# 클라이언트 측 인증서로 사용할 인증서 지정.

x = requests.head(url, cert='cert/hz.cert')

print(x.status_code) # 200 (※ 통신 성공 의미.)

 

---

cookies

선택. 지정 URL로 보낼 쿠키 Dictionary.

※ 기본값: None

 

(예제)

import requests

url = 'https://homzzang.com/python/demo.php'

# 서버에 쿠키 전송

x = requests.head(url, cookies = {"color": "red"})

print(x.status_code) # 200 (※ 통신 성공 의미.)

 

---

headers

선택. 지정 URL로 보낼 HTTP 헤더 Dictionary.

※ 기본값: None

 

(예제)

import requests

url = 'https://homzzang.com/python/demo.php'

# HTTP 헤더 설정.

x = requests.head(url, headers = {"HTTP_HOST": "홈짱닷컴"})

print(x.status_code) # 200 (※ 통신 성공 의미.)

 

---

proxies

선택. 프록시 URL에 대한 프로토콜 Dictionary.

※ 기본값: None

 

(예제)

import requests

url = 'https://homzzang.com/python/demo.php'

# 무료 프록시 주소 찾아 해당 프록시 통해 요청 보냄.

x = requests.head(url, proxies = { "https" : "https://1.1.0.1:80"})

print(x.status_code) # 200 (※ 통신 성공 의미.)

 

---

stream

선택. 응답 스트리밍 허용 여부 Boolean.

※ False : 허용 X (즉, 다운로드). (기본값)

※ True : 허용 O. (즉, 스트리밍).

 

(예제)

import requests

url = 'https://homzzang.com/python/demo.php'

# 스트리밍 허용.

x = requests.head(url, stream=True)

print(x.status_code) # 200 (※ 통신 성공 의미.)

 

---

timeout

선택. 클라이언트가 연결 (그리고/또는) 응답을 보낼 때까지 기다리는 시간 (초) 나타내는 Number 또는 Tuple.

※ 기본값: None. (즉, 연결 닫힐 때까지 요청 계속됨 의미.)

 

(예제)

import requests

url = 'https://homzzang.com/python/demo.php'

# timeout 설명 위해, 연결 시간 초과되게 매우 짧게 시간 설정.

x = requests.head(url, timeout=0.001)

print(x.status_code) # 200 (※ 통신 성공 의미.)

 

---

verify

선택. 서버 TLS 인증서 확인하는 Boolean 또는 문자열 표시.

※ True : 확인. (기본값)

※ False : 비확인.

 

(예제1)

import requests

url = 'https://homzzang.com/python/demo.php'

# TLS 인증서 경로 사용해 요청.

x = requests.head(url, verify='cert/tlscertificate')

print(x.status_code) # 200 (※ 통신 성공 의미.)

 

(예제2)

import requests

url = 'https://homzzang.com/python/demo.php'

# TLS 인증서 경로 사용 않고 요청.

x = requests.head(url, verify=False)

print(x.status_code) # 200 (※ 통신 성공 의미.)