← Все новости
Новый инструмент — 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».
