#257 · Herramienta para desarrolladores

Generador de ejemplos desde JSON Schema

Genera un documento JSON de ejemplo a partir de un JSON Schema sin depender de servicios externos. Prioriza const, examples, default y enum, crea objetos a partir de properties y produce un elemento de muestra para arrays. Puedes incluir todas las propiedades o limitar el resultado a las declaradas como required, lo que ayuda a preparar fixtures y documentación inicial.

Datos de entrada

JSON / JSON Schema
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Pega el contenido o carga un archivo compatible.
  2. Ajusta las opciones específicas del análisis cuando aparezcan.
  3. Pulsa el botón principal o usa Ctrl/Cmd + Enter.
  4. Revisa el resumen, la interpretación y los indicadores antes de copiar o descargar.

Qué hace esta herramienta para desarrolladores

Se resuelven reglas comunes de type, properties, required, items, enum, const, default, examples, oneOf/anyOf y combinaciones allOf sencillas.

Se resuelven reglas comunes de type, properties, required, items, enum, const, default, examples, oneOf/anyOf y combinaciones allOf sencillas.

El objetivo es producir un ejemplo útil, no demostrar que cubre todas las restricciones posibles del esquema.

Ejemplo

Un campo string con format=email genera user@example.com; un enum usa su primer valor disponible.

{
  "type": "object",
  "required": [
    "id",
    "email"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "active": {
      "type": "boolean",
      "default": true
    },
    "roles": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "user",
          "admin"
        ]
      }
    }
  }
}

Casos de uso

  • Crear fixtures a partir de contratos.
  • Incluir ejemplos en documentación API.
  • Probar formularios o clientes con una estructura válida de partida.

Consejos para obtener resultados fiables

  • Añade examples o default al esquema si necesitas valores representativos.
  • Revisa patrones y restricciones complejas manualmente.
  • Desactiva opcionales para obtener un payload mínimo.
  • Valida el ejemplo con un validador completo antes de usarlo como prueba de conformidad.

Detalles del procesamiento

La generación es determinista para facilitar snapshots y revisiones. Se anotan las decisiones aproximadas en alternativas y tipos no reconocidos.

No implementa todo el vocabulario de JSON Schema, resolución remota de $ref, dependencias condicionales, unevaluatedProperties ni síntesis completa de pattern.

Preguntas frecuentes

¿El ejemplo generado siempre valida contra el JSON Schema?

No se garantiza para vocabularios complejos. La herramienta cubre reglas frecuentes y produce un punto de partida que debe validarse con un validador completo.

¿Qué valor se elige cuando hay enum?

Se usa el primer elemento del enum para mantener una salida determinista.

¿Qué ocurre con oneOf o anyOf?

Se utiliza la primera alternativa y se registra un aviso para que revises la elección.

¿Puede generar solo las propiedades required?

Sí. Desactiva la inclusión de propiedades opcionales.

¿Resuelve referencias $ref remotas?

No. La generación es local y no realiza solicitudes de red ni resuelve referencias remotas.

Módulos del resultado

MóduloContenido
SalidaResultado listo para copiar o descargar
ResumenConteo y cambios principales
DiagnósticoInterpretación específica del procesamiento

Explorar la categoría

Consulta más utilidades de formato y datos en el hub de la categoría.

Formato y datos