Requests: HTTP for Humans™¶

Release v2.33.1. (Installation)

Requests 是一個優雅而簡單的 Python HTTP 程式庫，專為人類設計。

請看，這就是 Requests 的力量：

>>> r = requests.get('https://api.github.com/user', auth=('user', 'pass'))
>>> r.status_code
200
>>> r.headers['content-type']
'application/json; charset=utf8'
>>> r.encoding
'utf-8'
>>> r.text
'{"type":"User"...'
>>> r.json()
{'private_gists': 419, 'total_private_repos': 77, ...}

See similar code, sans Requests.

Requests allows you to send HTTP/1.1 requests extremely easily. There’s no need to manually add query strings to your URLs, or to form-encode your POST data. Keep-alive and HTTP connection pooling are 100% automatic, thanks to urllib3.

Beloved Features¶

Requests is ready for today’s web.

Keep-Alive & Connection Pooling
International Domains and URLs
Sessions with Cookie Persistence
Browser-style SSL Verification
自動內容解碼
Basic/Digest Authentication
Elegant Key/Value Cookies
自動解壓縮
Unicode Response Bodies
HTTP(S) Proxy Support
多部份檔案上傳
Streaming Downloads
Connection Timeouts
Chunked Requests
.netrc 支援

Requests officially supports Python 3.9+, and runs great on PyPy.

使用者指南¶

This part of the documentation, which is mostly prose, begins with some background information about Requests, then focuses on step-by-step instructions for getting the most out of Requests.

社群指南¶

This part of the documentation, which is mostly prose, details the Requests ecosystem and community.

API 文件/指南¶

If you are looking for information on a specific function, class, or method, this part of the documentation is for you.

Developer Interface

貢獻者指南¶

If you want to contribute to the project, this part of the documentation is for you.

There are no more guides. You are now guideless. Good luck.