YamlBox

JSON инструменты

Генератор схем от JSON до JSON

Вставьте образец полезной нагрузки и получите готовую к использованию схему JSON, которая документирует ее и проверяет будущие данные. Элементы массива разумно объединяются, а обязательные поля определяются автоматически.

Варианты конвертации

Образец JSON

Примеры: API полезная нагрузка · Массив записей —⌘/Ctrl + Enter преобразует · перетаскивает файл, чтобы загрузить его · обрабатывается локально

JSON Схема

Вывод доступен только для чтения. Используйте «Копировать», «Загрузить» или «Поделиться», чтобы удалить его.

Как использовать инструмент Схема от JSON до JSON

  1. Вставьте репрезентативный образец

    Чем богаче образец, тем лучше схема — включайте необязательные поля, значения NULL и как минимум два элемента массива, чтобы их формы можно было объединить.

  2. Выберите черновик

    Draft-07 поддерживается практически всеми валидаторами и редакторами; 2020-12 — текущая спецификация. Выбирайте в соответствии с вашей цепочкой инструментов.

  3. Используйте схему

    Вставьте его в AJV, Prisma, блок компонентов OpenAPI или в настройки схемы вашего редактора для мгновенной проверки и автозаполнения.

Чем отличается этот инструмент

  • Объединяет элементы массива в единую схему с общими обязательными полями.
  • Правильное определение целого числа и числа
  • Необязательное название, выход проекта 07 или 2020-12.
  • Вложенные объекты и массивы выводятся рекурсивно на любую глубину.
  • Никакие данные не покидают браузер — это безопасно для реальных полезных данных клиентов.

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

Схема от JSON до JSON — часто задаваемые вопросы

Насколько точна выведенная схема JSON?

Типы и структура соответствуют предоставленному вами образцу. Чего вывод не может знать, так это бизнес-правил — что возраст должен быть положительным или что поле является перечислением. Рассматривайте выходные данные как надежную отправную точку и добавляйте ограничения вручную.

Как обрабатываются массивы с элементами различной формы?

Схемы элементов объединяются: свойства, присутствующие в каждом элементе, становятся обязательными, а свойства, присутствующие только в некоторых элементах, остаются необязательными. Различия типов создают объединение, например type: ["строка", "число"].

Что выбрать: драфт-07 или 2020-12?

Выберите черновик-07, если вашим валидатором является AJV 6/7, старые редакторы или что-то еще, что не обновлялось в последнее время — он имеет самую широкую поддержку и соответствует ожиданиям большинства инструментов OpenAPI 3.0. Выберите 2020-12 год для новых проектов и AJV 8.

Где я могу использовать сгенерированную схему?

AJV и другие валидаторы для проверок во время выполнения, VS Code для автозаполнения и проверки файлов JSON, спецификации OpenAPI для документирования ответов API и конвейеры CI для сбоя сборки, когда ответ отклоняется от контракта.

Ищете “вывести схему JSON”, “создать схему json из json”, “генератор схем json”? Вы находитесь в правильном месте — просмотреть все инструменты 19.

Более глубокое чтение

Статья в блоге · 6 минута чтения Схема от JSON до JSON: от образца полезной нагрузки до Преобразуйте схему JSON в JSON в браузере: сделайте вывод о черновике из реальной полезной нагрузки, затем ужесточите обязательные поля, форматы и перечисления, а также ограничения на вывод. Читать руководство →