Генератор схемы GraphQL из JSON онлайн

Превратите образец JSON в определения типов GraphQL SDL прямо в браузере. Всё, что вы вставляете, никуда не отправляется.

Генератор схемы GraphQL из JSON работает полностью в вашем браузере. Образец JSON, который вы вставляете, и сгенерированный SDL никогда не загружаются в ArrayKit.

Открыть конвертер JSON в TypeScript

Об инструменте JSON в GraphQL

JSON to GraphQL Schema превращает образец JSON в готовый к использованию документ GraphQL SDL. Вставьте объект — и инструмент выведет блок `type Root`, сопоставляя числа с Int или Float, строки — со String, булевы значения — с Boolean, а любой ключ с именем id — со скаляром ID. Массивы становятся non-null типами списков вроде [String!]!, а вложенные объекты выделяются в собственные именованные типы (PascalCase из ключа поля), чтобы схема оставалась читаемой, а не глубоко вложенной. Это удобно, когда вы прототипируете GraphQL API на основе примера ответа, переносите REST-эндпоинт или набрасываете резолверы до того, как появится бэкенд. Задайте собственное имя корневого типа, скопируйте сгенерированный SDL или скачайте его как файл .graphql. Всё выполняется локально в вашем браузере — образец JSON никуда не загружается.

Возможности

Как использовать JSON в GraphQL

  1. Вставьте объект JSON в поле ввода или загрузите пример
  2. При желании задайте имя корневого типа
  3. Просмотрите сгенерированный GraphQL SDL справа
  4. Скопируйте схему или скачайте её как файл .graphql

Пример

Ввод

{"id":1,"name":"Ada"}

Результат

type Root {
  id: ID!
  name: String!
}

Поле id типизируется как ID, а name становится non-null String.

Частые ошибки и устранение неполадок

Часто задаваемые вопросы

Что генерирует Генератор схемы GraphQL из JSON?
Он читает образец JSON и выводит GraphQL SDL — один или несколько блоков `type` с именами полей и выведенными скалярными, списочными или объектными типами — которые можно вставить прямо в файл схемы GraphQL.
Как он решает между Int, Float, ID и String?
Целые числа становятся Int, а дробные — Float; любое поле, буквально названное "id", типизируется как скаляр ID в GraphQL; текст становится String, а true/false — Boolean.
Обрабатывает ли инструмент JSON в GraphQL вложенные объекты и массивы?
Да. Вложенные объекты становятся собственным именованным типом GraphQL (PascalCase из ключа поля), а массивы становятся non-null типами списков вроде [String!]!, при этом тип элемента выводится из первого элемента.
Могу ли я переименовать сгенерированный корневой тип?
Да. Используйте поле имени корневого типа — по умолчанию это "Root", но вы можете задать любое имя, например "User" или "Product", перед копированием схемы.
Загружается ли мой образец JSON куда-либо?
Нет. Генератор схемы GraphQL из JSON работает полностью в вашем браузере. JSON, который вы вставляете, и сгенерированный SDL никогда не покидают ваше устройство.
Что происходит с недействительным или некорректным JSON?
Инструмент показывает баннер с ошибкой, указывающий на проблему и, где возможно, строку и столбец, вместо того чтобы генерировать сломанную схему.

Связанные инструменты

Все инструменты ArrayKit