Desarrollo & API

Generador de JSON Schema: Crea esquemas válidos al instante

Convierte un payload de ejemplo en un esquema de validación.

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer"
    },
    "email": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "active": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "email",
    "tags",
    "active"
  ]
}

JSON, YAML & Data Wrangling Cheat Sheet

25 jq recipes, JSONPath syntax, reusable JSON Schema patterns and the YAML gotchas that break pipelines.

One email, no spam, unsubscribe any time.

Sobre esta herramienta

El generador recorre tu documento de ejemplo, infiere el tipo de cada valor, combina las estructuras de los elementos en arrays y marca las claves encontradas como requeridas: una base sólida que luego puedes ajustar manualmente.

Por qué generar un esquema

Los esquemas te permiten validar requests y responses en tu CI, generar clientes tipados y documentar tu API sin tener que redactar documentación a mano.

Ajustar el resultado

Añade formatos como date-time o email, limita los enums y ajusta la lista de campos requeridos para aquellos opcionales que el ejemplo haya incluido.

Cómo usar Generador de JSON Schema

  1. 1

    Abre el generador de JSON Schema

    Todo se ejecuta en esta página: no hay nada que instalar ni se requiere cuenta para usar las funciones gratuitas.

  2. 2

    Añade tu JSON de entrada

    Pega o introduce tus datos en el panel superior. La herramienta se actualiza mientras escribes para iterar rápido.

  3. 3

    Revisa el resultado

    Revisa el esquema, cópialo con un solo clic y ajusta las opciones hasta que coincida con lo que espera tu sistema.

  4. 4

    Ve un paso más allá

    Aplica las buenas prácticas y consejos de API a continuación para llevarlo a producción, y desbloquea el contenido extra en el formulario superior.

Buenas prácticas

  • Trabaja con un payload real y no con un ejemplo escrito a mano: los errores de codificación suelen ocultarse en espacios en blanco y caracteres Unicode.
  • Mantén la transformación reproducible: automatízala mediante scripts en tu CI una vez confirmado el resultado aquí.
  • Nunca pegues credenciales reales, datos de clientes o tokens de producción en una herramienta web que no hayas auditado.
  • Guarda versiones de los datos de entrada y salida para que un compañero pueda reproducir el mismo resultado más adelante.

Generador de JSON Schema — Por qué importa

Los pequeños detalles de integración (una codificación, un claim, un header) es donde residen la mayoría de los errores de API, y son costosos de rastrear en producción.

Asegurarlos en segundos acorta las sesiones de depuración y evita que lleguen datos malformados a tus sistemas secundarios.

Herramientas relacionadas, gratis y de pago

HerramientaTipoCaracterísticas claveEnlace
quicktypeFreeGenera tipos y esquemas a partir de JSON de ejemploVisitar
AjvFreeEl validador de JSON Schema más rápido para Node y navegadoresVisitar
ZodFreeValidación de esquemas TypeScript-first con inferenciaVisitar
StoplightOfertaFreemiumPlataforma de diseño de APIs con modelado de esquemas y lintingVisitar

Algunos enlaces marcados como Oferta son enlaces de socios. No te cuestan nada extra y ayudan a mantener estas herramientas gratuitas.

Herramientas relacionadas

Preguntas frecuentes