Адреса эмулятора
Адрес (эндпоинт) — это отдельный путь и HTTP-метод, которые обслуживает эмулятор. Для каждого адреса задаются шаблон ответа, время ответа и доля ошибочных ответов.
Список адресов открывается по клику на названии эмулятора в списке эмуляторов или через действие «Открыть». Возврат к списку эмуляторов — по ссылке «Генераторы» в строке навигации над заголовком.
Таблица адресов содержит колонки:
| Колонка | Содержание |
|---|---|
| «Название» | Имя адреса, ссылка на страницу «Настройки адреса» |
| «Адрес» | HTTP-метод и полный адрес вида хост:порт/путь, с кнопкой копирования |
| «Дата создания» | Дата и время создания адреса |
| «Дата обновления» | Дата и время последнего изменения адреса |
| «Автор» | Пользователь, создавший адрес |
| «Статус» | Переключатель и признак «Активен» или «Выключен» |
| «Действия» | «Переместить», «Удалить» |
Список фильтруется поиском по названию и по адресу.
Диспетчер передаёт эмулятору только адреса в статусе «Активен». Статус переключается прямо в таблице, без перехода на страницу настроек.
Создание адреса
-
Открыть эмулятор.
-
Нажать кнопку «Добавить адрес».
Адрес создаётся сразу, и открывается страница «Настройки адреса».
Новому адресу присваиваются значения по умолчанию: название «Без названия_» с отметкой даты и времени, метод GET, фиксированное время ответа 0 мс, статус «Выключен».
Название адреса изменяется по клику на заголовке страницы настроек.
Основные настройки
Карточка «Основные настройки» страницы «Настройки адреса» содержит:
- «Активен» — переключатель, обслуживает ли эмулятор этот адрес;
- «Адрес» — HTTP-метод (
GET,POST,PUT,DELETE), неизменяемая часть с хостом и портом эмулятора и путь.
Путь вводится без ведущего символа / — он подставляется автоматически.
Кнопка в правой части поля копирует полный адрес в буфер обмена.
Сочетание пути и метода уникально в пределах одного эмулятора: два адреса GET /cardNumber на одном эмуляторе создать нельзя.
Сопоставление входящего запроса с адресом выполняется точно, по полному пути и методу.
Параметры строки запроса при сопоставлении не учитываются — они доступны как источник данных для динамических полей.
Если подходящего активного адреса нет, эмулятор отвечает 404 Not Found.
Эмулятор обрабатывает запросы методами GET и POST.
Адреса с методами PUT и DELETE создаются в интерфейсе, но запросы этими методами эмулятор не обслуживает.
Время ответа и частота ошибок
Карточка «Настройка времени ответа и частоты ошибок» задаёт, как быстро и чем именно эмулятор отвечает.
Поле «Время ответа» переключает режим:
- «Фиксированное» — задаётся одно значение в поле «Время ответа, мс»;
- «Случайное» — задаётся диапазон полями «Время ответа минимум, мс» и «Время ответа максимум, мс», значение выбирается случайно внутри диапазона на каждый запрос.
Заданное время отсчитывается от момента поступления запроса: время, потраченное эмулятором на формирование ответа, входит в него, а не добавляется к нему.
Поле «Процент ошибочных ответов, %» задаёт долю запросов от 0 до 100, на которые эмулятор вместо шаблона ответа вернёт ошибку 500 Internal Server Error.
Решение принимается для каждого запроса отдельно, поэтому фактическая доля ошибок приближается к заданной на большом числе запросов.
Все изменения на странице применяются кнопкой «Сохранить настройки».
Перемещение адреса
Настроенный адрес переносится на другой эмулятор без повторной настройки:
-
Выбрать в действиях напротив адреса пункт «Переместить».
-
В окне «Перемещение адреса» выбрать эмулятор в поле «Выберите эмулятор».
-
Нажать кнопку «Переместить».
Вместе с адресом переносятся его шаблон ответа, динамические поля и настройки времени ответа. Переместить адрес нельзя, если на целевом эмуляторе уже есть адрес с таким же путём и методом.
Удаление адреса
Адрес удаляется действием «Удалить» напротив строки с подтверждением. Несколько адресов удаляются сразу: отметить их чекбоксами и нажать кнопку «Удалить» над списком адресов.