Активные маршруты
Показывает количество маршрутов, которые сейчас могут реально отвечать на входящие запросы.
Чтобы маршрут попал сюда, его состояние должно быть установлено как рабочее.
Черновики
Это маршруты, сохраненные для проверки и доработки.
Черновики не используются в рабочем рантайме, пока вы не переведете их в рабочее состояние.
404 за час
Показывает, сколько запросов за последний час не нашли подходящего маршрута и получили ответ 404.
Рост этого числа обычно означает, что в системе не хватает нужных путей или методов.
500 за час
Показывает количество внутренних ошибок за последний час.
Если значение растет, стоит проверить маршруты, шаблоны генерации ответов и файл php-error.log.
Средний RPS
RPS — это среднее число запросов в секунду за последний час.
Показатель помогает понять общую нагрузку на эмулятор.
Версия кэша
Это текущая версия подготовленной карты маршрутов.
При изменениях маршрутов версия меняется, а система понимает, что кэш нужно перестроить.
Состояние обработки логов
Показывает результат последней обработки входящих файлов логов.
Здесь можно увидеть, были ли новые файлы, сколько строк обработано и завершалась ли операция успешно.
Как пользоваться списком маршрутов
Список маршрутов нужен для поиска, фильтрации и быстрого открытия конкретного маршрута в редакторе.
Создание и подробное редактирование вынесены на отдельную страницу, чтобы форма не мешала просмотру списка.
Как пользоваться редактором маршрута
Редактор маршрута — это отдельный экран, где вы настраиваете один маршрут за раз.
После сохранения маршрут возвращается в общий список, а его скомпилированные данные обновляются автоматически.
Название маршрута
Короткое человекочитаемое имя, по которому маршрут удобно находить в списке.
На обработку запроса это поле не влияет, но очень помогает ориентироваться в большом наборе маршрутов.
Описание маршрута
Свободное поле для комментариев: зачем нужен маршрут, для какого сценария он сделан и что важно о нем помнить.
Метод
HTTP-метод запроса: например GET, POST или DELETE.
Маршрут будет реагировать только на выбранный метод.
Тип совпадения
Точное совпадение подходит для одного фиксированного пути.
Маска удобна, когда часть пути меняется, например идентификатор.
Регулярное выражение дает максимум гибкости, но требует внимательной настройки.
Шаблон пути
Это путь, с которым будет сравниваться входящий запрос.
Для маски можно использовать *, а для точного совпадения указывайте путь полностью.
Приоритет
Если несколько маршрутов подходят под один запрос, система выбирает маршрут с более высоким приоритетом.
Чем больше число, тем раньше маршрут будет рассмотрен.
Код ответа
HTTP-статус, который вернет маршрут: например 200, 201, 400 или 404.
Задержка
Искусственная пауза перед отправкой ответа в миллисекундах.
Нужна, когда вы хотите смоделировать медленную работу внешнего сервиса.
Состояние маршрута
Рабочий — маршрут сразу участвует в ответах на запросы.
Выключен — маршрут сохранен, но временно не используется.
Черновик — маршрут предназначен для подготовки и проверки, он не попадет в рабочий рантайм, пока вы не переведете его в рабочее состояние.
Это поле специально заменяет старую пару галок «Активен» и «Черновик», чтобы больше не было конфликтующих комбинаций.
Тело ответа
Это содержимое, которое получит клиент в ответе. Поле поддерживает обычный текст, JSON и шаблоны генерации внутри {{ ... }}.
Поддерживаемые генераторы faker:
{{faker:uuid}} — случайный UUID.
{{faker:email}} — тестовый email.
{{faker:inn}} — случайный ИНН из 10 цифр.
{{faker:timestamp}} — текущая дата и время в ISO-формате.
{{faker:int:10:99}} — случайное целое число в диапазоне.
{{faker:boolean}} — случайное булево значение true или false.
{{faker:firstname}} — случайное имя.
{{faker:lastname}} — случайная фамилия.
{{faker:fullname}} — случайные имя и фамилия.
{{faker:phone}} — телефон в тестовом формате.
{{faker:date}} — случайная дата в формате YYYY-MM-DD.
{{faker:companyname}} — случайное название компании.
Поддерживаемые служебные шаблоны:
{{ref:path.to.field}} — берет значение из уже сгенерированного поля ответа.
{{repeat:3:{"id":"{{faker:uuid}}"}}} — повторяет внутренний шаблон несколько раз и создает массив.
{{if:query.mode:full:{"ok":true}:{"ok":false}}} — сравнивает значение по пути и выбирает один из двух шаблонов.
В if путь может ссылаться как на данные запроса, так и на уже сгенерированные поля. Например: query.id, body.userId, headers.X-Token, path.partnerId.
Если нужно вывести буквально {{ или }}, их можно экранировать как \{{ и \}}.
Скомпилированный шаблон
После сохранения система может показать внутреннее представление маршрута, которое она использует для быстрого поиска совпадений.
Это технический диагностический блок: он нужен не для редактирования, а для проверки, как именно система поняла ваш путь и тип совпадения.
Если маршрут не ловит запрос так, как вы ожидаете, этот блок помогает увидеть, что было собрано внутри рантайма.
Для точного совпадения отдельный скомпилированный шаблон может вообще не требоваться — это нормально.
Файл описания API
Через это поле можно выбрать JSON-файл прямо с диска.
После выбора содержимое файла автоматически загрузится в поле ниже, а имя файла будет передано в систему как источник импорта.
Префикс пути
Это общий путь, который будет добавлен в начало каждого маршрута из импортируемого OpenAPI-описания.
Например, если указать /business/grants, то путь /list превратится в /business/grants/list.
Описание API в JSON
Сюда можно вставить OpenAPI JSON вручную, если файла под рукой нет или вы хотите быстро подправить содержимое перед импортом.
Почему импорт создает черновики
Импорт не включает маршруты в рабочий режим автоматически, чтобы случайно не заменить или не сломать уже настроенные ответы.
Сначала маршруты попадают в черновики, где их можно проверить, отредактировать и только потом активировать.
Профили импорта
Каждый профиль импорта — это одна операция загрузки OpenAPI-описания. Внутри профиля собраны все маршруты, созданные именно этим запуском.
Если импорт оказался неудачным, профиль можно удалить целиком, не выбирая маршруты по одному.
Для старых импортов, созданных до появления профилей, система показывает объединенную группу по имени исходного файла.
Сбросить кэш
Очищает текущую подготовленную карту маршрутов.
Полезно после заметных изменений, если вы хотите гарантированно заставить систему собрать данные заново.
Прогреть кэш
Заранее собирает и сохраняет карту маршрутов в кэш.
Это уменьшает задержку на первом запросе после обновлений.
Смена пароля администратора
Здесь задается новый пароль для входа в админку.
Раздел вынесен в отдельную вкладку, чтобы во время обычной работы с системой не менять пароль случайно.