Генерация кода и экспорт спецификации API

Перехваченные запросы годятся не только для просмотра, они могут сразу превращаться в готовый результат: один запрос в один клик становится работающим кодом (5 языков), целая сессия объединяется в полноценную спецификацию API (OpenAPI) или экспортируется в универсальный формат обмена HAR. Всё берётся прямо из реального захвата: ничего не нужно переписывать вручную и писать с нуля. Сессии, перехваченные в других инструментах, тоже можно импортировать и анализировать здесь.

1. Генерация кода: превращаем один запрос в работающий код

Перехватили запрос, который хотите воспроизвести или передать коллеге? Превратите его в готовый к запуску код одним кликом, а затем вставьте в терминал, добавьте в проект или отправьте коллеге.

5 форм, переключите язык, чтобы мгновенно перегенерировать, копируйте в один клик:

cURL (вставьте в терминал, и он выполнится)
Python
JavaScript
Go
OkHttp (Java / Kotlin)

Сгенерированный код полный: метод запроса, URL, все заголовки и тело. Заголовки сохраняют исходный порядок и любые дубликаты, порядок и повторяющиеся записи воспроизводятся в точности, поэтому то, что выполняется, точно соответствует реальному запросу и готово к использованию как есть.

Генерация кода: переключение между cURL / Python / JavaScript / Go / OkHttp, полный код с методом, заголовками и телом, копирование в один клик

Обычные инструменты при генерации кода часто меняют порядок и удаляют дубликаты заголовков, из-за чего воспроизведение расходится с оригиналом; здесь они сохраняются в точности, поэтому то, что выполняется, совпадает с реальным запросом.

Откуда генерировать

Список захвата: щёлкните правой кнопкой по любому запросу, затем «Сгенерировать код…».
Конструктор: настроив запрос в разделе Конструирование и повтор, нажмите «Сгенерировать код».

Когда использовать: воспроизвести реальный перехваченный запрос в виде скрипта или части проекта; экспортировать запрос в код после того, как он заработал в конструкторе, и продолжить разработку; передать один запрос коллеге (строку cURL сможет запустить кто угодно).

2. Экспорт спецификации API: превращаем сессию в OpenAPI

Перехватили участок API-трафика и хотите получить полноценную спецификацию? Инструмент автоматически упорядочивает эти запросы, объединяет их в список эндпоинтов и в один клик генерирует документ OpenAPI, без ручного написания.

Сначала анализ, потом экспорт: инструмент автоматически определяет эндпоинты в текущей сессии и перечисляет их для проверки, поэтому вы экспортируете только выбранное и избегаете шума. В списке для каждого эндпоинта сразу видны метод, путь, число обращений и наблюдавшиеся коды состояния, что даёт ясную картину с первого взгляда.
Автоматическое объединение путей: пути с конкретными идентификаторами шаблонизируются, например /users/123 становится /users/{id}, а несколько запросов к одному эндпоинту объединяются в один.
Автоматический вывод структуры: инструмент объединяет структуру JSON запросов / ответов, группирует ответы по кодам состояния и раскладывает переменные пути в параметры.
Формирует стандартный OpenAPI 3.0: его можно скопировать или скачать, а затем импортировать в любой инструмент, совместимый с OpenAPI, и продолжить работу.

Экспорт OpenAPI: слева отмечаете эндпоинты (метод / путь / число обращений / коды состояния), справа живой предпросмотр автоматически выведенной спецификации OpenAPI 3.0

Когда использовать: после захвата API-трафика быстро получить готовую, импортируемую спецификацию OpenAPI; аналитическая работа, интеграция со сторонними API, дополнение документации для бэкенд-команды или построение тест-кейсов для QA.

3. Импорт и экспорт: совместимость с другими инструментами

Перехваченный трафик не заперт внутри, а трафик, перехваченный в других инструментах, можно подгрузить сюда. Единый стандартный формат обмена сессиями связывает оба направления:

Экспорт в HAR: в один клик экспортируйте весь захват в стандартный файл HAR 1.2 для передачи, архивирования или дальнейшего анализа в другом инструменте.
Импорт сессий, перехваченных другими: импортируйте внешние файлы сессий захвата (HAR 1.2, .pcap / .pcapng, а также файлы сессий, экспортированные распространёнными инструментами захвата), чтобы пакеты, перехваченные кем-то другим, можно было подгрузить для просмотра, сравнения и экспорта.

Когда использовать: подгрузить трафик, перехваченный в продакшене, коллегой или другими инструментами, и продолжить анализировать его здесь с помощью декодеров, профилей хостов и сравнения запросов; либо экспортировать участок перехваченного здесь трафика в универсальный формат для передачи.

Назад к Захвату через прокси · Смотрите также: Конструирование и повтор · Просмотр и декодирование