JSON Swiss

JSON Swiss

Generador de C++ Class a JSON Schema

Entrada Código C++

1

Salida JSON Schema

Configuración

Elige qué clase/struct se trata como raíz del JSON Schema.

El parseo ocurre completamente en tu navegador. Tu código nunca sale de esta página.

Pega tus clases C++ para producir JSON Schema al instante.

Soporta structs, campos públicos, STL containers comunes y referencias anidadas.

Cómo convertir clases y structs de C++ a JSON Schema — guía paso a paso

Este convertidor en línea (C++ class → JSON Schema) te ayuda a generar JSON Schema desde modelos reales (DTOs, structs y classes) para validar payloads, compartir contratos y generar mock JSON.

  1. Paso 1 – Pega tu fuente C++

    • Pega los modelos que quieres documentar en el editor izquierdo.
    • Incluye tipos referenciados en el mismo snippet para que el esquema pueda generar definitions.
    • Usa el botón Ejemplo para cargar un ejemplo y ver el formato esperado.

  2. Paso 2 – Selecciona el Clase raíz (si hace falta)

    • Si se detectan múltiples definitions, elige la raíz que coincide con tu payload de API.
    • El esquema de salida se construye alrededor de la raíz seleccionada e incluye definitions para tipos referenciados.

  3. Paso 3 – Revisa la salida de JSON Schema

    • Comprueba tipos, campos requeridos vs. opcionales y estructuras anidadas de objetos/arrays.
    • Busca definitions y $ref cuando tus modelos referencien otros modelos.
    • Copia o descarga el esquema para validación, documentación o desarrollo schema-first.

  4. Paso 4 – Valida o genera mock JSON

    • Haz clic en Generar datos mock para abrir el generador de mock con tu esquema precargado.
    • Valida payloads reales contra tu esquema para detectar cambios incompatibles temprano.
    • Si dependes de composición avanzada del schema (por ejemplo anyOf/oneOf/allOf), verifica el resultado con un validador completo como Ajv.

Nota sobre soporte de keywords

Los esquemas generados pueden incluir $ref y puedes editarlos para añadir anyOf, oneOf, o allOf. Para esquemas complejos, usa un validador completo de JSON Schema y haz dereference antes de generar mock si es necesario.

Herramientas relacionadas de JSON Schema y generación de código

Usa estas herramientas para validar schemas, generar payloads mock, formatear ejemplos JSON y mantener código y contratos sincronizados.

Generador de datos mock (JSON Schema)

Genera JSON de ejemplo desde tu schema para testing, fixtures y documentación.

Validador de JSON Schema

Valida JSON contra keywords comunes de schema y encuentra diferencias rápidamente.

JSON a clases C++

Genera tipos y modelos de C++ desde muestras JSON.

Generador JSON → JSON Schema

Construye un schema desde muestras JSON representativas para complementar schemas model-first.

Biblioteca de JSON Schema

Explora ejemplos y patrones para objetos, arrays, enums y restricciones.

Formateador JSON

Limpia ejemplos JSON antes de validar contra schema o compartir documentación.

Preguntas frecuentes

¿Qué C++ está soportado?

El convertidor lee definiciones de clases/structs con miembros públicos, campos tipados, contenedores STL como std::vector/std::map, tipos primitivos y structs anidados. Los punteros y las referencias se tratan como campos opcionales, por lo que puedes pegar directamente cabeceras DTO u objetos de mensajes.

¿Cómo se mapean tipos de C++ a JSON Schema?

Los tipos primitivos se convierten en string/number/boolean de JSON. std::vector<T>, std::list<T>, los arrays y std::array se convierten en arrays del esquema, mientras que std::map<string, T> se convierte en un objeto con additionalProperties. Los tipos definidos por el usuario que no se conozcan se convierten en string, salvo que también se proporcione una clase con ese nombre.

¿Puedo elegir la clase raíz?

Sí. Si se detectan múltiples tipos, abre settings y selecciona la raíz en el dropdown. El schema se construye alrededor de esa raíz.

¿Cómo genero datos mock desde el schema?

Tras generar el schema, haz clic en "Generar datos mock" para abrir el Generador de Mock con el schema precargado y producir payloads de ejemplo.