Hướng dẫn python requests raise for status - tăng yêu cầu python cho trạng thái

Đưa ra yêu cầu Jo

Đưa ra yêu cầu với yêu cầu rất đơn giản.

Bắt đầu bằng cách nhập mô -đun yêu cầu:

Bây giờ, hãy để cố gắng để có được một trang web. Ví dụ này, hãy để Lừa nhận được dòng thời gian công khai của GitHub:

>>> r = requests.get('https://api.github.com/events')

Bây giờ, chúng ta có một đối tượng

>>> r = requests.get('https://api.github.com/events')

>>> r = requests.get('https://api.github.com/events')

Yêu cầu API đơn giản có nghĩa là tất cả các dạng yêu cầu HTTP là rõ ràng. Ví dụ: đây là cách bạn thực hiện yêu cầu bài đăng HTTP:

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

Tốt đẹp? Còn các loại yêu cầu HTTP khác: đặt, xóa, đầu và tùy chọn? Tất cả đều đơn giản như vậy:

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

Đó là tất cả tốt và tốt, nhưng nó cũng chỉ là sự khởi đầu của những gì yêu cầu có thể làm.

Vượt qua các tham số trong URLS¶

Bạn thường muốn gửi một số loại dữ liệu trong chuỗi truy vấn URL. Nếu bạn đang xây dựng URL bằng tay, dữ liệu này sẽ được cung cấp dưới dạng các cặp khóa/giá trị trong URL sau một dấu hỏi, ví dụ:

>>> r = requests.get('https://api.github.com/events')

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

Bạn có thể thấy rằng URL đã được mã hóa chính xác bằng cách in URL:

>>> print(r.url)
https://httpbin.org/get?key2=value2&key1=value1

Lưu ý rằng bất kỳ khóa từ điển nào có giá trị là

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

Bạn cũng có thể vượt qua danh sách các mục dưới dạng giá trị:

>>> payload = {'key1': 'value1', 'key2': ['value2', 'value3']}

>>> r = requests.get('https://httpbin.org/get', params=payload)
>>> print(r.url)
https://httpbin.org/get?key1=value1&key2=value2&key2=value3

Nội dung phản hồi

Chúng ta có thể đọc nội dung của phản hồi máy chủ. Hãy xem xét dòng thời gian GitHub một lần nữa:

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

Yêu cầu sẽ tự động giải mã nội dung từ máy chủ. Hầu hết các ký tự Unicode được giải mã liền mạch.

Khi bạn đưa ra yêu cầu, các yêu cầu đưa ra những dự đoán có giáo dục về việc mã hóa phản hồi dựa trên các tiêu đề HTTP. Mã hóa văn bản được đoán bằng các yêu cầu được sử dụng khi bạn truy cập

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

nodes[certname] { certname == "bastion" }

Nếu bạn thay đổi mã hóa, các yêu cầu sẽ sử dụng giá trị mới là

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

Yêu cầu cũng sẽ sử dụng mã hóa tùy chỉnh trong trường hợp bạn cần chúng. Nếu bạn đã tạo mã hóa của riêng mình và đăng ký nó với mô -đun

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

>>> r = requests.post('https://httpbin.org/post', data={'key': 'value'})

Nội dung phản hồi nhị phân

Bạn cũng có thể truy cập phần thân phản hồi dưới dạng byte, cho các yêu cầu không phải là văn bản:

nodes[certname] { certname == "bastion" }

Các mã hóa chuyển khoản

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

Mã mã hóa

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

Ví dụ: để tạo hình ảnh từ dữ liệu nhị phân được trả về bởi một yêu cầu, bạn có thể sử dụng mã sau:

nodes[certname] { certname == "bastion" }

Nội dung phản hồi JSON

Ngoài ra, còn có một bộ giải mã JSON tích hợp, trong trường hợp bạn đang xử lý dữ liệu JSON:

nodes[certname] { certname == "bastion" }

Trong trường hợp giải mã JSON thất bại,

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

Cần lưu ý rằng sự thành công của lời kêu gọi

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

Nội dung phản hồi RAW

Trong trường hợp hiếm hoi mà bạn muốn nhận phản hồi ổ cắm thô từ máy chủ, bạn có thể truy cập

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

nodes[certname] { certname == "bastion" }

Tuy nhiên, nói chung, bạn nên sử dụng một mẫu như thế này để lưu những gì đang được truyền vào một tệp:

nodes[certname] { certname == "bastion" }

Sử dụng

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

Ghi chú

Một lưu ý quan trọng về việc sử dụng

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

>>> r = requests.put('https://httpbin.org/put', data={'key': 'value'})
>>> r = requests.delete('https://httpbin.org/delete')
>>> r = requests.head('https://httpbin.org/get')
>>> r = requests.options('https://httpbin.org/get')

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

>>> payload = {'key1': 'value1', 'key2': 'value2'}
>>> r = requests.get('https://httpbin.org/get', params=payload)

Yêu cầu bài đăng phức tạp hơn

Thông thường, bạn muốn gửi một số dữ liệu được mã hóa biểu mẫu-giống như một biểu mẫu HTML. Để làm điều này, chỉ cần chuyển một từ điển cho đối số

>>> print(r.url)
https://httpbin.org/get?key2=value2&key1=value1

nodes[certname] { certname == "bastion" }

Đối số

>>> print(r.url)
https://httpbin.org/get?key2=value2&key1=value1

>>> print(r.url)
https://httpbin.org/get?key2=value2&key1=value1

nodes[certname] { certname == "bastion" }

Có những lúc bạn có thể muốn gửi dữ liệu không được mã hóa mẫu. Nếu bạn vượt qua

>>> print(r.url)
https://httpbin.org/get?key2=value2&key1=value1

>>> print(r.url)
https://httpbin.org/get?key2=value2&key1=value1

Ví dụ: API V3 của GitHub chấp nhận dữ liệu bài đăng/bản vá được mã hóa JSON:

nodes[certname] { certname == "bastion" }

Xin lưu ý rằng mã trên sẽ không thêm tiêu đề

>>> payload = {'key1': 'value1', 'key2': ['value2', 'value3']}

>>> r = requests.get('https://httpbin.org/get', params=payload)
>>> print(r.url)
https://httpbin.org/get?key1=value1&key2=value2&key2=value3

>>> payload = {'key1': 'value1', 'key2': ['value2', 'value3']}

>>> r = requests.get('https://httpbin.org/get', params=payload)
>>> print(r.url)
https://httpbin.org/get?key1=value1&key2=value2&key2=value3

Nếu bạn cần bộ tiêu đề đó và bạn không muốn tự mã hóa

>>> print(r.url)
https://httpbin.org/get?key2=value2&key1=value1

>>> payload = {'key1': 'value1', 'key2': ['value2', 'value3']}

>>> r = requests.get('https://httpbin.org/get', params=payload)
>>> print(r.url)
https://httpbin.org/get?key1=value1&key2=value2&key2=value3

nodes[certname] { certname == "bastion" }

PQL parse error at line 1, column 29:

nodes[certname] { certname == "bastion" }
                            ^

Expected one of:

[
false
true
#"[0-9]+"
-
'
"
#"\s+"

Lưu ý, tham số

>>> payload = {'key1': 'value1', 'key2': ['value2', 'value3']}

>>> r = requests.get('https://httpbin.org/get', params=payload)
>>> print(r.url)
https://httpbin.org/get?key1=value1&key2=value2&key2=value3

>>> print(r.url)
https://httpbin.org/get?key2=value2&key1=value1

>>> payload = {'key1': 'value1', 'key2': ['value2', 'value3']}

>>> r = requests.get('https://httpbin.org/get', params=payload)
>>> print(r.url)
https://httpbin.org/get?key1=value1&key2=value2&key2=value3

Đăng một tập tin được mã hóa nhiều phần

Các yêu cầu làm cho việc tải lên các tệp được mã hóa nhiều phần đơn giản: đơn giản là đơn giản:

PQL parse error at line 1, column 29:

nodes[certname] { certname == "bastion" }
                            ^

Expected one of:

[
false
true
#"[0-9]+"
-
'
"
#"\s+"

Bạn có thể đặt tên tệp, content_type và tiêu đề một cách rõ ràng:

PQL parse error at line 1, column 29:

nodes[certname] { certname == "bastion" }
                            ^

Expected one of:

[
false
true
#"[0-9]+"
-
'
"
#"\s+"

Nếu bạn muốn, bạn có thể gửi chuỗi được nhận dưới dạng tệp:

PQL parse error at line 1, column 29:

nodes[certname] { certname == "bastion" }
                            ^

Expected one of:

[
false
true
#"[0-9]+"
-
'
"
#"\s+"

Trong trường hợp bạn đang đăng một tệp rất lớn dưới dạng yêu cầu

>>> payload = {'key1': 'value1', 'key2': ['value2', 'value3']}

>>> r = requests.get('https://httpbin.org/get', params=payload)
>>> print(r.url)
https://httpbin.org/get?key1=value1&key2=value2&key2=value3

>>> payload = {'key1': 'value1', 'key2': ['value2', 'value3']}

>>> r = requests.get('https://httpbin.org/get', params=payload)
>>> print(r.url)
https://httpbin.org/get?key1=value1&key2=value2&key2=value3

>>> payload = {'key1': 'value1', 'key2': ['value2', 'value3']}

>>> r = requests.get('https://httpbin.org/get', params=payload)
>>> print(r.url)
https://httpbin.org/get?key1=value1&key2=value2&key2=value3

Để gửi nhiều tệp trong một yêu cầu, hãy tham khảo phần nâng cao.advanced section.

Cảnh báo

Bạn nên mở các tệp ở chế độ nhị phân. Điều này là do các yêu cầu có thể cố gắng cung cấp tiêu đề

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

Mã trạng thái phản hồi

Chúng tôi có thể kiểm tra mã trạng thái phản hồi:

PQL parse error at line 1, column 29:

nodes[certname] { certname == "bastion" }
                            ^

Expected one of:

[
false
true
#"[0-9]+"
-
'
"
#"\s+"

Yêu cầu cũng đi kèm với đối tượng Tra cứu mã trạng thái tích hợp để dễ dàng tham khảo:

PQL parse error at line 1, column 29:

nodes[certname] { certname == "bastion" }
                            ^

Expected one of:

[
false
true
#"[0-9]+"
-
'
"
#"\s+"

Nếu chúng tôi đưa ra một yêu cầu xấu (lỗi máy khách 4xx hoặc phản hồi lỗi máy chủ 5xx), chúng tôi có thể nâng nó bằng

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

PQL parse error at line 1, column 29:

nodes[certname] { certname == "bastion" }
                            ^

Expected one of:

[
false
true
#"[0-9]+"
-
'
"
#"\s+"

Nhưng, vì

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

>>> r = requests.get('https://api.github.com/events')

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

PQL parse error at line 1, column 29:

nodes[certname] { certname == "bastion" }
                            ^

Expected one of:

[
false
true
#"[0-9]+"
-
'
"
#"\s+"

Tất cả đều tốt.

Bánh quy¶

Nếu phản hồi chứa một số cookie, bạn có thể nhanh chóng truy cập chúng:

PQL parse error at line 1, column 29:

nodes[certname] { certname == "bastion" }
                            ^

Expected one of:

[
false
true
#"[0-9]+"
-
'
"
#"\s+"

Để gửi cookie của riêng bạn đến máy chủ, bạn có thể sử dụng tham số

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

PQL parse error at line 1, column 29:

nodes[certname] { certname == "bastion" }
                            ^

Expected one of:

[
false
true
#"[0-9]+"
-
'
"
#"\s+"

Cookie được trả lại trong một

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

>>> print(r.url)
https://httpbin.org/get?key2=value2&key1=value1

>>> r = requests.get('https://api.github.com/events')

Chuyển hướng và Lịch sử

Theo yêu cầu mặc định sẽ thực hiện chuyển hướng vị trí cho tất cả các động từ ngoại trừ đầu.

Chúng ta có thể sử dụng thuộc tính

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

Danh sách

nodes[certname] { certname == "bastion" }

>>> r = requests.get('https://api.github.com/events')

Ví dụ: GitHub chuyển hướng tất cả các yêu cầu HTTP đến HTTPS:

>>> r = requests.get('https://api.github.com/events')

Nếu bạn sử dụng GET, tùy chọn, đăng, đặt, vá hoặc xóa, bạn có thể vô hiệu hóa xử lý chuyển hướng với tham số

nodes[certname] { certname == "bastion" }

>>> r = requests.get('https://api.github.com/events')

Nếu bạn sử dụng đầu, bạn cũng có thể kích hoạt chuyển hướng:

>>> r = requests.get('https://api.github.com/events')

Hết thời gian

Bạn có thể nói các yêu cầu dừng chờ phản hồi sau một số giây nhất định với tham số ____10103. Gần như tất cả mã sản xuất nên sử dụng tham số này trong gần như tất cả các yêu cầu. Không làm như vậy có thể khiến chương trình của bạn treo vô thời hạn:

>>> r = requests.get('https://api.github.com/events')

Ghi chú

nodes[certname] { certname == "bastion" }

nodes[certname] { certname == "bastion" }

nodes[certname] { certname == "bastion" }

Lỗi và ngoại lệ

Trong trường hợp có vấn đề về mạng (ví dụ: thất bại DNS, kết nối bị từ chối, v.v.), các yêu cầu sẽ tăng ngoại lệ

nodes[certname] { certname == "bastion" }

>>> import requests

>>> r = requests.get('https://api.github.com/events')
>>> r.text
'[{"repository":{"open_issues":0,"url":"https://github.com/...

nodes[certname] { certname == "bastion" }

Nếu một yêu cầu hết thời gian, một ngoại lệ

nodes[certname] { certname == "bastion" }

Nếu một yêu cầu vượt quá số lượng chuyển hướng tối đa được cấu hình, ngoại lệ

nodes[certname] { certname == "bastion" }

Tất cả các trường hợp ngoại lệ yêu cầu tăng rõ ràng kế thừa từ

nodes[certname] { certname == "bastion" }

Sẵn sàng để biết thêm? Kiểm tra phần nâng cao.advanced section.

Nếu bạn có mặt trên thị trường việc làm, hãy xem xét việc thực hiện bài kiểm tra lập trình này. Một quyên góp đáng kể sẽ được thực hiện cho dự án này, nếu bạn tìm được một công việc thông qua nền tảng này.