HTTP-клиент Connekt
Редакция: OpenIDE Pro.
Connekt — встроенный HTTP-клиент OpenIDE. Запросы описываются Kotlin-скриптами с расширением .connekt.kts и лежат в репозитории рядом с кодом: их видно в код-ревью как обычные файлы, и после коммита они доступны всей команде. Переносить запросы из личной коллекции не нужно.
Видеогайд
Разбор тестирования API с практикой в Connekt — «Тестирование API простыми словами + практика | Postman, Connekt, HTTP» на канале OpenIDE. В нём видно, как выглядит работа со сценариями в IDE и чем она отличается от привычных инструментов.
Отдельный разбор Connekt со Spring Boot, защищёнными эндпоинтами и цепочками вызовов — в записи эфира на 1,5 часа; таймкоды — в анонсе на Habr.
Сторонние материалы: обзор Connekt от Домклика — как команда Домклика использует клиент в работе; статья «Как тестировать API прямо в IDE, или почему я больше не использую Postman» — про проверки через Kotlin Power Assert и AssertJ.
Что умеет
- Все методы:
GET,POST,PUT,PATCH,DELETE,HEAD,OPTIONS,TRACE. Заголовки, query-параметры, path-параметры, тело запроса. - Окружения в файле
connekt.env.json— один сценарий запускается на dev, staging и prod. - Сценарии из нескольких шагов с передачей результата между запросами.
- Проверки ответов, включая мягкие проверки, которые собирают все ошибки за один запуск.
- OAuth 2.0, Basic и Bearer.
- Загрузка и скачивание бинарных файлов, свой SSL-сертификат.
- Отладка запроса в отладчике IDE.
- Запуск тех же скриптов вне IDE: из консоли и в конвейере CI/CD.
Чем это отличается от привычных инструментов
| Connekt | |
|---|---|
| Postman | Сценарии живут в репозитории проекта, а не в личной или облачной коллекции. Тесты пишутся на Kotlin, а не на JavaScript, и работают вместе с автодополнением и проверкой типов в IDE |
| HTTP Client IntelliJ IDEA | Полноценный язык вместо формата .http: результат запроса можно сохранить в объект, передать в следующий шаг и переиспользовать без повторного разбора JSON |
| cURL в терминале | Запрос генерируется от эндпоинта приложения, отлаживается в отладчике IDE и в любой момент копируется обратно в формат cURL |
Работа с объектами точнее, чем со строками: IDE подсказывает поля, типы проверяются при компиляции скрипта.
Панель Structure и навигация
Панель Structure автоматически группирует HTTP-запросы проекта и даёт быстрый переход к нужному сценарию. Навигация работает и в обратную сторону — между эндпоинтами приложения и их вызовами, как для обычного кода. Для существующего эндпоинта запрос можно сгенерировать из класса контроллера, не вводя URL вручную.
Запрос можно отладить как код: поставить брейкпоинт, посмотреть значения переменных и пройти сценарий шаг за шагом.
Открытый исходный код
Connekt разрабатывается открыто: github.com/Amplicode/connekt. Проект состоит из двух частей — библиотеки Connekt Script Definition, которая задаёт сам DSL, и Connekt Scripting Host, который выполняет скрипты. Из этого следует практичное свойство: скрипты не привязаны к IDE, их можно запускать из консоли и в CI/CD.
Генерация сценариев из контроллеров
Amplicode создаёт Connekt-сценарии для REST-контроллеров Spring: из класса контроллера получается набор запросов и проверок, которые можно сразу запускать. Connekt входит и в бесплатную версию Amplicode, и в OpenIDE.
Скрипты и AI-агент
Сценарии Connekt умеет писать AI-агент: в наборе Spring Agent Toolkit для этого есть отдельный навык connekt-script-writer. Формулировка задачи выглядит так: «Напиши Connekt-скрипт, который проверяет создание заказа». Те же навыки для Claude Code, Codex, OpenCode и других агентов лежат в репозитории Amplicode/spring-skills.
Разделы
- Первый запрос — файл
.connekt.kts, объявление запроса и запуск из редактора. - Окружения — файл
connekt.env.json, типы переменных, переключение между стендами. - Сценарии из нескольких шагов —
useCase, передача результата черезpathParam, типизация ответа. - Переменные и кеширование —
byвместо=, повторное использование токена, время жизни значения. - Проверки ответов — проверки по кодам, заголовкам и JSON, мягкие проверки.
- OAuth 2.0 — client id и secret, получение и переиспользование токена.
- Файлы и SSL — бинарные файлы, свой сертификат, настройки клиента.
- Импорт запросов —
.http, коллекции Postman, cURL. - Запуск вне IDE — консоль, Docker, CI/CD.