Сеанси запису

Сеанс запису спостерігає за вебсторінкою, поки ви нею користуєтеся, і фіксує кожен API-виклик, який вона робить: REST, GraphQL, gRPC-web і WebSocket. Захоплені виклики переглядаються як звичайні відповіді, а на планах Pro та Enterprise перетворюються на папку справжніх запитів для повторного виконання, заздалегідь заповнених тим, що сторінка насправді надіслала.

Це найкоротший шлях задокументувати API, від якого у вас є лише фронтенд: жодного проксі для налаштування, жодного сертифіката для встановлення, жодного розширення браузера.

Створення сеансу

Сеанс створюється будь-де в дереві — у корені, у папці або в папці середовища — з контекстного меню («Додати» → «Сеанс запису») або з меню «Створити»; лише сценарій не може його містити. У бічній панелі він відображається як батьківський вузол: клацання на самому сеансі відкриває його сторінку налаштування, а кожен з його дочірніх рядків відкриває власну вкладку.

Сторінка налаштування сеансу запису: url сторінки, протоколи для захоплення, білий і чорний списки та кнопка Почати запис

Налаштування зводиться до чотирьох елементів:

Url сторінки, яку слід відкрити в міні-браузері (http://, https:// або file://). Кнопка «Почати запис» залишається неактивною, доки url не буде дійсним.
Протоколи для захоплення: HTTP, WebSocket, GraphQL, gRPC-web — усі позначені за замовчуванням.
Білий список: регулярні вирази; виклик зберігається, якщо відповідає хоча б одному з них. Порожній список пропускає все.
Чорний список: регулярні вирази; виклик, що відповідає одному з них, відкидається. Останнє слово завжди за чорним списком.

У файлі проєкту зберігаються лише ці налаштування та виведені маршрути. Захоплені ж виклики залишаються в пам’яті: вони зникають після закриття проєкту й ніколи не записуються на диск.

Запис

Кнопка «Почати запис» відкриває сторінку у вкладці міні-браузера та під’єднує записувач ще до першого завантаження, тому виклики, які сторінка робить під час запуску — включно з одразу відкритим з’єднанням WebSocket — потрапляють у захоплення. Пульсівне сяйво навколо позначки сеансу в бічній панелі та навколо його вкладки показує, що запис триває.

Міні-браузер під час запису: сторінка сайту, кнопки Призупинити запис і Зупинити запис в адресному рядку, червона позначка на сеансі

Переглядайте сторінку та користуйтеся нею як завжди. Дві кнопки в адресному рядку керують сеансом:

Призупинити запис залишає сторінку відкритою, але припиняє зберігати виклики — зручно, щоб пропустити нецікавий екран.
Зупинити запис від’єднує записувач і закриває вкладку браузера. Захоплення залишаються доступними.

Запис завжди є явною дією: вкладка браузера, відновлена після повторного відкриття застосунку, нічого не записує.

Сайти, яким потрібне ваше місцезнаходження, запитують його в браузера, і типово міні-браузер нічого не розкриває. Налаштування Надавати ваше місцезнаходження вбудованому браузеру, у розділі Конфіденційність налаштувань застосунку, типово вимкнене, надає ваше приблизне місцезнаходження після запиту вашої згоди — від системної служби геолокації, а за її відсутності — з оцінки на рівні міста за вашою IP-адресою. Його вимкнення одразу забуває місцезнаходження.

Захоплення

Рядок «Захоплення» сеансу відкриває перегляд викликів, згрупованих за виконанням від найстарішого до найновішого і оновлюваних у реальному часі під час запису. Доки список прокручено до самого низу, він стежить за найновішими викликами; прокрутіть угору, щоб прочитати один із них, і список залишиться на місці. Поле фільтра звужує список; деталі виклику використовують точно ті самі вкладки відповіді, що й запити (тіло, відомості, cookie, граф), протокол за протоколом.

Перегляд захоплень: список викликів, згрупованих за виконанням, зліва; деталі вибраного виклику з його вкладками відповіді справа

Контекстне меню виклику пропонує додати його до білого або чорного списку, з його url як заздалегідь заповненим шаблоном. Новий шаблон можна застосувати й до вже захоплених викликів: ті, що більше не проходять, видаляються остаточно — застосунок запитує підтвердження.

Кількість викликів, що зберігаються на сеанс, обмежена (1 000 за замовчуванням, змінюється в налаштуваннях застосунку); понад цю межу найстаріші видаляються.

Виведення маршрутів

На планах Pro та Enterprise кнопка Вивести маршрути в перегляді захоплень перетворює виклики на дерево під рядком «Маршрути» сеансу:

виклики групуються за маршрутом: сегмент шляху, що змінюється від виклику до виклику (/pets/1, /pets/2), стає параметром шляху {{petId}};
папки повторюють статичні префікси шляхів (api › pets); виклики gRPC-web розкладаються за сервісами;
кожен маршрут стає звичайним запитом — HTTP, GraphQL, gRPC-web або WebSocket — заздалегідь заповненим з останнього успішного виклику (заголовки, параметри, тіло) і готовим до негайного повторного виконання;
захоплені виклики записуються до історії відповідей кожного запиту у звичному форматі та в межах налаштованого ліміту зберігання; за замовчуванням показується відповідь останнього успішного виклику.

Розгорнутий рядок Маршрути сеансу: виведені папки та їхні запити, готові до повторного виконання

Повторний запуск виведення після нових записів об’єднує: додаються лише нові маршрути, а наявні запити — включно з тими, які ви змінили — залишаються недоторканими.

На плані Community запис і перегляд захоплень доступні повністю; вкладка Маршрути показує нагадування про функцію Pro.

З ШІ-асистента

Уся функція доступна через сервер MCP Restorm: створення й налаштування сеансу, запуск і зупинка запису, читання захоплень і виведення маршрутів. Тож агент може відкрити сторінку, дати їй попрацювати, а потім передати вам папку готових до використання запитів.