13. OpenAPI Design

Что вы узнаете

  • Как открыть режим Design для OpenAPI
  • Как редактировать и валидировать спецификацию
  • Как генерировать запросы из описания

СКРИНШОТ №12 — Режим Design: редактор OpenAPI, предпросмотр, генерация запросов

Переход в Design

  1. Создайте или выберите рабочую область типа Design Document (Document).
  2. В хлебных крошках нажмите вкладку Document — откроется экран Design.
  3. В центре откроется редактор OpenAPI (YAML/JSON) с подсветкой и автодополнением.

Редактирование

  • Центральный редактор — текст спецификации, справа можно открыть предпросмотр Swagger UI.
  • Панель lint отображает ошибки/предупреждения Spectral; клик по сообщению переводит к строке.
  • Над редактором доступны кнопки Format и переключение панелей Lint/Preview.

Генерация запросов

  1. В предпросмотре найдите нужный endpoint.
  2. Нажмите Generate Request — Pechkin создаст HTTP-запрос в текущей рабочей области, заполнив метод, URL, параметры и пример тела.
  3. Запрос появится в боковой панели; его можно запустить или отредактировать.

Импорт/экспорт спецификации

  • Импорт OpenAPI файла или URL доступен в 15 Импорт и экспорт.
  • Сохранённые изменения сохраняются в рабочей области и, при подключённом Git, фиксируются в репозитории.

Предыдущий: 12. Тестирование и Runner
Следующий: 14. Мок-серверы