Перейти к основному содержанию

Генератор примеров JSON Schema

API reference

Генерация примеров JSON-данных по JSON Schema для документации API, имитации ответов и тестовых фикстур. Детерминированный режим: один и тот же schema и seed всегда дают одинаковый результат. Работает полностью в вашем браузере.

Ввод

При значении больше одного результаты оборачиваются в массив (или выводятся по одному на строку для NDJSON).

Один и тот же schema, seed и настройки всегда дают одинаковые данные. Измените, чтобы получить другой набор.

Ограничивает рекурсивные schema ($ref, которые ссылаются сами на себя), чтобы вложенность не росла бесконечно.

Вывод

Примеры данных
 
Это было полезно?

Другие способы использовать этот инструмент

REST API

curl -X POST https://api.iotools.cloud/v1/tool/json-schema-sample-generator \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "schema": "{\"type\":\"object\",\"required\":[\"id\",\"email\"],\"prop…",
    "count": "1",
    "format": "pretty",
    "optional": "all",
    "seed": "42",
    "maxDepth": "6"
  }'

Подставьте свой собственный ключ из аккаунта. Поля инструмента — это тело запроса, без обёртки.

Спросите у ИИ-агента

Use the IOTools `json-schema-sample-generator` tool (JSON Schema Sample Generator) on this input:

YOUR_INPUT_HERE

Вставьте это любому агенту, подключённому к MCP-серверу IOTools, и добавьте свой ввод.

Виджет для встраивания

<iframe
  src="https://iotools.cloud/embed/json-schema-sample-generator/"
  width="100%" height="520" frameborder="0" scrolling="no" loading="lazy"
  title="Генератор примеров JSON Schema — iotools.cloud"
  sandbox="allow-scripts allow-forms allow-same-origin allow-downloads allow-popups allow-popups-to-escape-sandbox"
  allow="clipboard-write"
  style="width:100%;border:1px solid #e5e7eb;border-radius:12px;overflow:hidden"></iframe>
<script src="https://iotools.cloud/embed.js" async></script>

Вставьте это на свою страницу — бесплатно, без ключа, нужна лишь обратная ссылка.

Стоимость вызова API/MCPОт 5 кредитов
Нужно больше кредитов?Посмотреть тарифы

Также доступно через

Руководства

Превратите JSON Schema в пример данных, которым можно пользоваться на практике: payload для документации API, имитированные ответы, плейсхолдеры для фронтенда и тестовые фикстуры. Вставьте схему и получите валидный JSON. Ничего не загружается на сервер: генератор работает в вашем браузере.

Результат детерминированный (seeded) — это то, что упускают большинство генераторов примеров: одна и та же схема, seed и настройки всегда дают байт-в-байт одинаковые данные. Поэтому результат можно сохранить как фикстуру и генерировать заново без лишних изменений в диффе, а при необходимости другого набора просто поменять seed.

Как пользоваться

  1. Вставьте JSON Schema в поле ввода.
  2. Передвиньте Количество примеров вверх, если нужно больше одной записи — при 2 и более они оборачиваются в массив (или выводятся по одной записи на строку в режиме NDJSON).
  3. Выберите формат вывода: JSON с отступами, JSON в одну строку или NDJSON для наполнения базы данных или конвейера логов.
  4. Настройте Необязательные свойства, чтобы определить, насколько близко пример придерживается набора обязательных полей.
  5. Скопируйте или скачайте результат.

Настройки

  • Seed — любой текст. Тот же seed на входе — те же данные на выходе. Измените, чтобы получить новый набор.
  • Необязательные свойства — Включить все заполняет каждое объявленное свойство; Только обязательные выводит лишь ключи из required (хорошая проверка того, что ваши потребители справляются с минимальным payload); Включать случайно варьирует их от примера к примеру, что ближе к реальному трафику.
  • Макс. глубина — насколько глубоко рекурсировать, прежде чем остановиться пустым объектом/массивом. Без этого схема, где запись в $defs ссылается сама на себя (узел дерева, ветка комментариев), вкладывалась бы бесконечно.

Что понимает генератор

type (включая массивы типов), properties, required, items — как в одиночной, так и в кортежной форме — enum, const, default, examples, oneOf, anyOf, allOf, а также локальные указатели $ref в $defs или definitions. Учитываются числовые ограничения (minimum, maximum, exclusiveMinimum, exclusiveMaximum, multipleOf), строковые (minLength, maxLength) и массивные (minItems, maxItems, uniqueItems).

Фиксированные значения имеют приоритет в таком порядке: const, затем default, затем examples, и только потом выбор из enum. Поэтому схема с "type": {"const": "user"} всегда получит "user", а не случайное слово.

Почему значения выглядят реалистично, а не как "string1"?

Два источника сигнала. Сначала учитывается format — email, uri, uuid, date, date-time, time, duration, hostname, ipv4, ipv6 и json-pointer дают корректно оформленное значение. Если format нет, используется имя свойства: поле email, createdAt, city, phone, price или id получает правдоподобное значение для своего имени. Благодаря этому сгенерированная документация API читается намного легче.

Поддерживается ли pattern?

Нет — синтез строки по произвольному регулярному выражению — это другая задача, и неверная догадка хуже очевидного плейсхолдера. Строка, у которой есть только pattern, получает слово из набора. Добавьте format, enum или default, если значение должно точно соответствовать.

Какие драфты JSON Schema поддерживаются?

Перечисленные выше ключевые слова общие для Draft-07, 2019-09 и 2020-12, поэтому схемы из любого из них работают. Поддерживаются как $defs, так и старый definitions. Удалённые URL в $ref не загружаются — сначала встройте их, так как здесь ничего не обращается к сети.

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

Обратное действие — вывод схемы из уже имеющихся данных — выполняет JSON Schema Generator. Чтобы проверить, что payload действительно соответствует схеме, используйте JSON Schema Validator. Если нужны имитированные записи без написания схемы вовсе, Fake Data Generator принимает простой список полей.

jsonjson-schemasample datamock datatest datafixturesapigenerator

Нравятся инструменты? Уберите рекламу.

Один платёж навсегда убирает всю рекламу с вашего аккаунта. Без подписки, без слежки.