Convertidor JSON a clases C#

¿Qué hace esta herramienta?

Genera definiciones de clases C# a partir de un objeto JSON de muestra. Es un punto de partida para modelos de respuestas de APIs, DTO y pruebas en proyectos .NET. Crea una clase Root, clases para objetos anidados y propiedades con JsonPropertyName para conservar los nombres JSON. El procesamiento ocurre en tu navegador; revisa los tipos antes de usar el código en producción.

Cómo utilizarla

1. Pega un objeto JSON válido y representativo de la respuesta que quieres modelar.
2. Presiona Generar clases C# y revisa Root, las clases anidadas y los atributos JsonPropertyName.
3. Selecciona Copiar resultado y pega las definiciones en un archivo .cs de tu proyecto .NET; ajusta el espacio de nombres según tu proyecto.
4. Revisa nulabilidad, colecciones, números y nombres. Inicializa las referencias cuando corresponda y prueba la deserialización con JsonSerializer.

Ejemplos de entrada y salida

{"order_id":42,"total":19.95,"customer":{"name":"Ada"},"tags":["paid"],"note":null}

using System.Collections.Generic;
using System.Text.Json.Serialization;

public class Root
{
    [JsonPropertyName("order_id")]
    public int OrderId { get; set; }

    [JsonPropertyName("total")]
    public double Total { get; set; }

    [JsonPropertyName("customer")]
    public Customer Customer { get; set; }

    [JsonPropertyName("tags")]
    public List<string> Tags { get; set; }

    [JsonPropertyName("note")]
    public object? Note { get; set; }
}

public class Customer
{
    [JsonPropertyName("name")]
    public string Name { get; set; } = string.Empty;
}

Limitaciones importantes

• Exige un objeto en la raíz; no acepta un arreglo, null ni un valor primitivo como raíz. No lee esquemas ni combina varias muestras.
• Infiere string, bool e int para enteros de 32 bits; los demás números se convierten en double. No detecta decimal, long, fechas, enumeraciones ni GUID a partir de cadenas. El análisis JSON puede perder precisión en números grandes.
• Un valor null genera object?: no permite conocer el tipo real. No infiere propiedades ausentes, campos obligatorios ni la nulabilidad de futuros valores.
• Los arreglos usan solo el primer elemento no nulo para inferir List<T>. Un arreglo vacío o compuesto solo de null genera List<object>; no combina tipos ni propiedades de los demás elementos.
• Las propiedades string se inicializan con string.Empty; las referencias a objetos y listas no se inicializan. Revisa advertencias de referencias anulables, colisiones de nombres y compatibilidad con tu configuración de C#.

Errores comunes

• Pegar JSON inválido o una lista de objetos en la raíz. Selecciona un objeto representativo de la lista para generar el modelo.
• Confiar en que una sola muestra describe todas las variantes de una API.
• Usar double para importes monetarios sin revisar si el contrato necesita decimal.
• Usar las clases generadas sin revisar nulabilidad, nombres, inicialización ni deserialización con datos reales.

Preguntas frecuentes