Перейти к основному содержимому

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 вручную.

Панель Structure: запросы файла собраны в список, клик по узлу открывает нужный запрос в редакторе
Переход от запроса к методу контроллера и обратно — тем же действием Go to Declaration or Usages (⌘B / Ctrl+B)

Запрос можно отладить как код: поставить брейкпоинт, посмотреть значения переменных и пройти сценарий шаг за шагом.

Открытый исходный код​

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.

Разделы​