Python: уроки, справочник и задачи

Модуль requests

Раздел: Модули и библиотеки Python · Обновлено 31.10.2026

Модуль requests: разбор темы с примерами кода на Python 3 из раздела "Модули и библиотеки Python". Показаны основные функции, параметры и рабочие примеры кода с результатом выполнения.

Модуль requests
Фото: ProjectManhattan / CC BY-SA 3.0, Wikimedia Commons
Содержание статьи
  1. Введение
  2. Установка библиотеки requests
  3. Основные методы библиотеки requests
    1. Отправка GET-запроса
    2. Отправка POST-запроса
    3. Отправка PUT-запроса
    4. Отправка DELETE-запроса
  4. Обработка ответов
  5. Подробная документация
  6. Заключение

Введение

Библиотека requests - это эффективный и простой в использовании инструмент для работы с HTTP-запросами в языке программирования Python. Она предоставляет удобный интерфейс для отправки запросов на серверы, обработки ответов и управления параметрами запросов.

Установка библиотеки requests

Для установки библиотеки requests необходимо выполнить следующую команду в командной строке:

pip install requests

Основные методы библиотеки requests

Здесь разобраны такие пункты: отправка GET-запроса, отправка POST-запроса, отправка PUT-запроса, отправка DELETE-запроса.

Отправка GET-запроса

Get запрос является одним из HTTP методов, используемых для получения данных с веб-сервера. Этот метод позволяет получить информацию из указанного ресурса, не изменяя его состояния. Get запросы широко используются веб-разработчиками для получения данных, таких как HTML страницы, изображения, JSON или другие файлы.

import requests
# Указываем URL, на который будем отправлять GET-запрос
url = 'https://api.example.com/data'
# Отправляем GET-запрос по указанному URL
response = requests.get(url)
# Проверяем статус-код ответа
if response.status_code == 200:
    # Если статус-код 200 (OK), получаем данные из ответа в формате JSON
    data = response.json()
    print(data)
else:
    # В случае ошибки выводим сообщение
    print('Ошибка при выполнении запроса')

Отправка POST-запроса

POST запрос является еще одним HTTP методом, используемым для отправки данных на веб-сервер. В отличие от Get запроса, который используется для получения данных, POST запрос позволяет отправлять данные для обработки на сервере, часто с целью создания, обновления или удаления ресурсов.

# Отправляем POST-запрос на указанный URL с данными {'key': 'value'}
response = requests.post(url, data={'key': 'value'})

POST запросы широко используются при отправке форм, загрузке файлов, выполнении сложных операций на сервере и других сценариях, где требуется передача данных на сервер для обработки. Они также не кэшируются браузерами, что делает их подходящими для операций, изменяющих состояние сервера.

Отправка PUT-запроса

PUT запрос также является HTTP методом и используется для обновления данных на веб-сервере. Этот метод предназначен для изменения существующего ресурса или создания нового, если он не существует. PUT запросы позволяют указать конкретный URI, куда нужно поместить обновленные данные.

# Отправляем PUT-запрос на указанный URL с данными {'key': 'value'}
response = requests.put(url, data={'key': 'value'})

PUT запросы широко используются при обновлении данных, например, при изменении информации о товарах, профилях пользователей и других ресурсах на сервере. Они позволяют точечно обновлять данные в соответствии с указанным URI.

Отправка DELETE-запроса

DELETE запрос является HTTP методом, используемым для удаления указанного ресурса с веб-сервера. Этот метод предназначен для удаления существующей информации на сервере.

# Отправляем DELETE-запрос на указанный URL
response = requests.delete(url)

DELETE запросы широко применяются для удаления данных, таких как файлы, записи в базе данных или другие ресурсы на сервере. Они позволяют эффективно удалять информацию и освобождать ресурсы на сервере.

Кроме основных методов, библиотека requests также предоставляет возможности для отправки запросов с различными заголовками, параметрами и файлами.

Обработка ответов

После отправки запроса и получения ответа можно выполнять множество операций с полученными данными. Например, можно получить содержимое ответа в виде текста, JSON или бинарных данных. Также можно обрабатывать статус-коды ответов, заголовки и cookies.

Подробная документация

Библиотека requests обладает обширной и полноценной документацией, включающей в себя описание всех методов, параметров и возможностей. Рекомендуется обратиться к официальной документации для получения более подробной информации.

Заключение

Библиотека requests в Python представляет собой незаменимый инструмент для работы с HTTP-запросами. Благодаря своему простому и интуитивно понятному интерфейсу она широко используется в различных проектах, связанных с веб-разработкой и API-интеграцией.