Saltar al contenido
Asistente de esquemas

JSON a esquema OpenAPI

Genera un esquema de componente OpenAPI a partir de JSON de ejemplo.
Los objetos y arreglos se traducen a JSON Schema con campos requeridos, y los arreglos mixtos se expresan con oneOf.
Todo se ejecuta localmente en tu navegador; no se envían datos a ningún servidor.

Guía: Cómo usarlo y características

  • Pega el JSON en el campo de entrada y pulsa «Convertir a OpenAPI».
  • Los objetos se expanden a JSON Schema con properties y la lista de required.
  • Los arreglos infieren el tipo de elementos; si hay mezcla, la salida usa oneOf.
  • Puedes copiar el resultado o limpiar los campos para empezar de nuevo.

Ejemplos: Ejemplos de entrada y salida

Infer schema from a profile object

Entrada

{"name":"Jane","email":"[email protected]","verified":true}

Salida

{
  "type": "object",
  "properties": {
    "name": {"type": "string"},
    "email": {"type": "string", "format": "email"},
    "verified": {"type": "boolean"}
  },
  "required": ["name", "email", "verified"]
}

FAQ: Preguntas frecuentes

  • ¿Cómo se ve la salida?

    Se genera components.schemas.Root como JSON Schema con properties y required.
  • ¿Qué pasa con arreglos mixtos o valores null?

    Se infiere cada elemento; si hay varios tipos, el arreglo usa oneOf. Los null se expresan con nullable: true.
  • ¿Se envían datos a algún servidor?

    No. Todo se ejecuta localmente en tu navegador sin peticiones de red.

Casos de uso: Usos habituales

  • Drafting schemas

    Transform JSON samples into OpenAPI schema stubs to seed documentation or mock generation.

  • Sharing endpoint expectations fast

    Convert request/response examples and paste them into PRs or issues to align on contract details.

  • Checking consistency with existing specs

    Compare generated stubs with current definitions to spot fields that need updates.

Notas: Notas y limitaciones

  • Todo se queda en el navegador

    Las entradas y salidas permanecen en tu dispositivo. Al cerrar la pestaña o borrar la caché, se eliminan los estados temporales.

  • Valida los datos críticos

    Los resultados son un apoyo; revísalos antes de enviarlos a sistemas productivos o compartirlos externamente.

  • Cargas grandes dependen del dispositivo

    Textos o archivos muy extensos pueden ir más lentos en algunos navegadores. Para tareas pesadas, usa un entorno de escritorio.

Generador de schema OpenAPI desde JSON

Convierte una muestra JSON en un schema OpenAPI para documentar responses, requests y componentes reutilizables. Ayuda a crear una base rápida para components.schemas sin escribir cada propiedad manualmente.

Cuándo resulta útil

  • Documentar endpoints: parte de una respuesta real para crear el schema inicial.
  • Crear contratos de API: revisa tipos, propiedades requeridas y estructuras anidadas.
  • Acelerar documentación: genera borradores para Swagger u OpenAPI.

Revisa manualmente campos opcionales, formatos especiales, arrays y restricciones como enum, minLength o format.

Artículos para esta herramienta

Artículos recientes

Caso de uso
2026-08-07

Opciones de curl: qué hacen realmente -X, -H y -d

Referencia de las opciones de curl que aparecen en el trabajo diario con APIs: por qué -d ya implica POST, en qué se diferencia de --data-raw, la @ inicial que lee un archivo sin avisar, comillas simples frente a dobles, y por qué -k y -L merecen más cuidado del habitual.

Introducción
2026-08-06

Convertir entre JSON Schema y Zod: cómo se corresponden required y .optional()

Por dentro de un conversor bidireccional que transforma JSON Schema en un esquema de Zod y el código Zod de vuelta a JSON Schema. Incluye los valores por defecto invertidos entre required y .optional(), la tabla de correspondencia de restricciones y cómo se analiza Zod sin ejecutar código.

Caso de uso
2026-08-06

Orden de evaluación en SQL: por qué WHERE no ve el alias del SELECT

El orden en que escribe las cláusulas de SQL no es el orden en que se ejecutan. Referencia del orden lógico (FROM → WHERE → GROUP BY → HAVING → SELECT → ORDER BY → LIMIT), por qué fallan los alias en WHERE, cuándo usar WHERE y cuándo HAVING, ONLY_FULL_GROUP_BY y la trampa de LEFT JOIN con WHERE.

Caso de uso
2026-08-06

Formato unified diff: cómo leer las cabeceras @@ de git diff

Cómo leer el formato unified diff que genera git: qué significan los cuatro números de @@ -12,7 +12,9 @@, por qué un cambio de un solo carácter aparece como línea completa reemplazada, las trampas de los espacios y los finales de línea, \ No newline at end of file, los diffs combinados @@@ en los merges y la detección de renombrados.

Caso de uso
2026-08-06

Conversión UTC⇄JST: tabla del desfase de 9 horas y errores de zona horaria

Convierta entre UTC y la hora de Japón (JST) con una tabla de referencia, y vea por qué la diferencia con España cambia entre 7 y 8 horas según el horario de verano. Incluye el significado de Z y +09:00 en ISO 8601, cuándo JavaScript desplaza las fechas, el comportamiento de MySQL/PostgreSQL y por qué el cron de GitHub Actions siempre corre en UTC.

Caso de uso
2026-08-04

Referencia de CREATE TABLE: tipos y restricciones en MySQL, PostgreSQL y SQLite

Referencia de CREATE TABLE (DDL) con tablas comparativas entre bases de datos: tipos de datos, autoincremento (AUTO_INCREMENT / IDENTITY / rowid), comportamiento de ON DELETE en claves foráneas y la restricción CHECK que MySQL ignora en silencio.

Anuncio

Anuncio