requests.request

Синтаксис

requests.request(method, url, **kwargs)

Аргументы

• method – метод для нового объекта Request: GET, OPTIONS, HEAD, POST, PUT, PATCH или DELETE.
• url – URL для нового объекта Request.
• params – (необязательный) словарь, список кортежей или байты, отправляемые в строке запроса.
• data – (необязательный) словарь, список кортежей, байты или объект, подобный файлу, отправляемые в теле запроса.
• json – (необязательный) сериализуемый в JSON объект Python, отправляемый в теле запроса.
• headers – (необязательный) словарь HTTP-заголовков, отправляемых вместе с запросом.
• cookies – (необязательный) словарь или объект CookieJar, отправляемые вместе с запросом.
• files – (необязательный) словарь вида {'name': file-like-objects} (или {'name': file-tuple}) для загрузки с использованием multipart-энкодинга. file-tuple может быть 2-кортежем ('filename', fileobj), 3-кортежем ('filename', fileobj, 'content_type') или 4-кортежем ('filename', fileobj, 'content_type', custom_headers), где 'content_type' — строка, определяющая тип содержимого файла, а custom_headers — объект, подобный словарю, содержащий дополнительные заголовки для файла.
• auth – (необязательный) кортеж для аутентификации, позволяющий использовать Basic/Digest/Custom HTTP-аутентификацию.
• timeout (float или tuple) – (необязательный) количество секунд ожидания данных от сервера перед завершением попытки; может быть указано числом с плавающей точкой или кортежем (тайм-аут подключения, тайм-аут чтения).
• allow_redirects (bool) – (необязательный) логическое значение. Включает или отключает перенаправления для методов GET/OPTIONS/POST/PUT/PATCH/DELETE/HEAD. По умолчанию True.
• proxies – (необязательный) словарь, сопоставляющий протокол с URL прокси-сервера.
• verify – (необязательный) либо логическое значение, определяющее проверку TLS-сертификата сервера, либо строка с путем к CA bundle. По умолчанию True.
• stream – (необязательный) если False, содержимое ответа будет загружено сразу.
• cert – (необязательный) если строка, то путь к файлу клиентского SSL-сертификата (.pem). Если кортеж, то пара (‘cert’, ‘key’).

Пример использования

>>> import requests
>>> req = requests.request('GET', 'https://httpbin.org/get')
>>> req
<Response [200]>