HTTP - запросы

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

Настройки запросов

настройки

• Переименовать — Изменение названия рассылки
• Удалить — Безвозвратное удаление рассылки

Ссылка

Изменение ссылки запроса

Метод запроса

Доступны следующие типы запросов:

Базовые (основные) методы запросов в большинстве API:

• GET — только получение данных, безопасный, идемпотентный, кешируемый
• POST — создание/отправка данных, не идемпотентный, меняет состояние

Второстепенные (узкоспециализированные) методы запросов:

• HEAD — как GET, но только заголовки (без тела ответа), для проверки
• PUT — полное обновление/создание ресурса, идемпотентный
• DELETE — удаление ресурса, идемпотентный
• CONNECT — установка туннеля (для прокси/SSL)
• OPTIONS — информация о поддерживаемых методах (CORS)
• TRACE — диагностика, возвращает полученный запрос (для отладки)
• PATCH — частичное обновление ресурса, не идемпотентный

Параметры

Параметры всех запросов состоят из 3х частей:

Query

Query (Параметры запроса) — Часть URL после знака вопроса ?, состоящая из пар ключ=значение, разделенных &.

Пример: https://api.example.com/users?page=2&limit=10&sort=name

Для чего нужно:

• Фильтрация данных (?category=books)
• Пагинация (?page=3&limit=20)
• Сортировка (?sort=price&order=desc)
• Поиск (?q=telegram+bot)

Не для конфиденциальных данных (видны в истории браузера, логах)

Headers

Headers (Заголовки) — Мета-данные запроса/ответа в виде пар ключ: значение. Идут перед телом.

Для чего нужно:

• Аутентификация (Authorization)
• Указание типа данных (Content-Type, Accept)
• Кеширование (Cache-Control)
• CORS-политики (Access-Control-Allow-Origin)
• Информация о клиенте (User-Agent)

Body

Body (Тело запроса) — Основные данные запроса (для методов POST, PUT, PATCH) или ответа сервера.

Для чего нужно:

• Передача больших объемов данных
• Создание/обновление ресурсов (пользователи, статьи, заказы)
• Загрузка файлов
• Сложные структурированные данные