← Все новости

Новый инструмент — GraphQL: схема SDL и интерактивная карта типов

В «Помощнике SA» появился редактор GraphQL. Слева — схема API на языке SDL, справа — интерактивная карта типов, как в GraphQL Voyager, но в оформлении сервиса: карточки типов с полями, стрелки от полей к типам их значений, интерфейсы и объединения.

Что умеет редактор

  • Проверка по мере ввода. Синтаксис и корректность схемы: неизвестные типы, повторные определения, реализация интерфейсов, допустимые типы аргументов. Сообщения — на русском, с номером строки.
  • Карта схемы. Строится от корня Query, Mutation или Subscription — или из всех типов сразу. Щелчок по типу подсвечивает его связи, щелчок по полю — связь поля, двойной щелчок открывает определение в коде.
  • Панель «Описание». Поиск типов и полей, описание выбранного типа: поля с аргументами и значениями по умолчанию, интерфейсы, члены объединений, значения перечислений, устаревшие поля.
  • Relay без шума. Обёртки Connection, Edge и PageInfo сворачиваются в списки — на карте остаётся суть. Галочками можно скрыть устаревшие поля и поля-скаляры.
  • Introspection. Вставьте JSON-ответ запроса __schema существующего API — редактор покажет его карту. Выгрузка — в SDL, introspection JSON, SVG и PNG.

Как и в остальных инструментах

Песочница работает без регистрации. В аккаунте — история версий, проекты и совместная работа команды, ИИ-подсказки при вводе и ИИ-ревью схемы по лучшим практикам: именование, обязательность полей, мутации с payload-типами, пагинация, эволюция через @deprecated. Схемы доступны агентам через API и MCP — с той же проверкой синтаксиса.

Карту схемы можно встроить в Confluence виджетом «Помощника SA» по ссылке «Поделиться». Синтаксис GraphQL с примерами — в разделе «Документация → GraphQL».