HTTP - запросы

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

Интерфейс

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

Функция	Описание
Переименовать	Изменение названия рассылки
Удалить	Безвозвратное удаление рассылки

Ссылка

Адрес, на который будет отправлен запрос. Поддерживаются

https://.

Важно:

Максимальная длина URL — 2048 символов

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

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

Базовые (основные) методы запросов в большинстве 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: Bearer token)
Тип данных (Content-Type: application/json)
Кеширование (Cache-Control)
Информация о клиенте (User-Agent)

Ограничения:

ключ заголовка — до 256 символов, значение — до 4096 символов

Body

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

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

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

В EnotPro доступны три режима:

Режим	Описание	Когда использовать
Off	Тело запроса не отправляется	Для GET-запросов
Template	Вы вводите текст вручную (JSON, XML, текст)	Когда данные статичны или собираются из макросов
Path	Указываете путь к файлу на сервере	Для отправки файлов или очень больших данных

Ограничение:

Максимальный размер тела запроса — 1 МБ.

Авто Content-Type

EnotPro автоматически подставляет заголовок Content-Type в зависимости от формата вашего тела запроса:

Если в Body...	Автоматический Content-Type
{ "key": "value" }	application/json
text	application/xml
name=value&other=data	application/x-www-form-urlencoded
Обычный текст	text/plain

Полезно:

Вам не нужно вручную указывать Content-Type в заголовках — платформа сделает это за вас. Но если нужен специфичный тип, вы можете переопределить его вручную в заголовках.

Триггеры (Подготовка и Завершение)

У HTTP-запроса есть два специальных триггера для гибкой настройки:

Триггер подготовки (Pre-request)

Выполняется перед отправкой запроса. Позволяет:

Динамически подставить параметры запроса
Обновить заголовки перед отправкой
Выполнить проверки (например, есть ли токен)

Триггер завершения (Post-request)

Выполняется после получения ответа от сервера. Позволяет:

Обработать полученные данные (распарсить JSON, сохранить в переменные)
Проверить код ответа (200, 404, 500)
Выполнить действия в зависимости от результата (уведомить пользователя, повторить запрос)

Сводная таблица ограничений

Параметр	Максимальный размер
URL	2048 символов
Ключ заголовка	256 символов
Значение заголовка	4096 символов
Тело запроса	1 МБ