¡Convierte JSON en class de C#!

¡Introduce JSON para generar código class de C#, incluidos los objetos anidados! Compatible con System.Text.Json [JsonPropertyName], .NET, ASP.NET Core.
JSON
Resultado
 

¡Convierte JSON en class de C#!

Convierte JSON en clases C# para System.Text.Json. Los nombres de propiedad pasan a PascalCase, y cada propiedad lleva un atributo [JsonPropertyName] para que se vincule exactamente a la clave original.

Te ahorra copiar y teclear los modelos de petición y respuesta de ASP.NET Core, los tipos para llamadas HttpClient.GetFromJsonAsync<T>() a APIs externas y las clases de datos en apps de Unity o MAUI.

Cómo usar

  1. Pega una respuesta JSON o un archivo de configuración.
  2. Escribe el nombre de la clase raíz en Nombre del tipo (por ejemplo PaymentResult).
  3. Lleva las clases generadas a un archivo .cs y añade tu namespace.
  4. Úsalas con JsonSerializer.Deserialize<PaymentResult>(json) o GetFromJsonAsync<PaymentResult>(url).

Ejemplo

Entrada (JSON)
{
  "paymentId": "pay_8f2k",
  "amount": 15000,
  "currency": "KRW",
  "approved": true,
  "approvedAt": "2024-05-01T12:30:00Z",
  "card": { "issuer": "VISA", "last4": "4242" },
  "metadata": null
}
Salida (C# · System.Text.Json)
using System.Collections.Generic;
using System.Text.Json;
using System.Text.Json.Serialization;

public class PaymentResult
{
    [JsonPropertyName("paymentId")]
    public string PaymentId { get; set; } = string.Empty;

    [JsonPropertyName("amount")]
    public int Amount { get; set; }

    [JsonPropertyName("currency")]
    public string Currency { get; set; } = string.Empty;

    [JsonPropertyName("approved")]
    public bool Approved { get; set; }

    [JsonPropertyName("approvedAt")]
    public string ApprovedAt { get; set; } = string.Empty;

    [JsonPropertyName("card")]
    public Card Card { get; set; } = new();

    [JsonPropertyName("metadata")]
    public JsonElement? Metadata { get; set; }
}

public class Card
{
    [JsonPropertyName("issuer")]
    public string Issuer { get; set; } = string.Empty;

    [JsonPropertyName("last4")]
    public string Last4 { get; set; } = string.Empty;
}

Todas las propiedades tienen [JsonPropertyName], así que paymentId ↔ PaymentId coinciden sin importar las reglas de mayúsculas. metadata solo vale null, así que su tipo es desconocido y pasa a JsonElement?. Las propiedades de cadena y de objeto reciben inicializadores string.Empty / new() para que el código compile sin advertencias de nullable.

Funciones compatibles

  • [JsonPropertyName("originalKey")] en cada propiedad, con using System.Text.Json.Serialization;.
  • Tipos: string, int, long para enteros de más de 32 bits, double para decimales, bool y List<T> para arrays.
  • Los valores de tipo mixto o desconocido pasan a JsonElement, y se añade using System.Text.Json;.
  • Las propiedades que faltan en algunos elementos o contienen null pasan a ser nullable (int?, string?).
  • Las propiedades obligatorias reciben inicializadores = string.Empty; o = new(); para evitar la advertencia CS8618 de tipos de referencia nullable.
  • C# no permite que una propiedad se llame igual que su clase, así que recibe el sufijo Value (p. ej. RootValue).
  • Un array de nivel superior genera un comentario // Root: List<RootItem> y la clase del elemento.

Casos de uso

Llamar a APIs externas con HttpClient

Convierte una respuesta de ejemplo de una API de pagos o de seguimiento de envíos y úsala como tipo en await http.GetFromJsonAsync<PaymentResult>(url), en lugar de sacar los campos uno a uno de un JsonDocument.

Modelos de payload de webhooks en ASP.NET Core

Genera clases a partir del payload que te envía un servicio de terceros y recíbelo como parámetro [FromBody], para que el model binding y la validación funcionen como siempre.

appsettings y archivos de datos de juegos

Fijar en clases la estructura de un archivo de datos JSON que lee una app de Unity o de consola hace que un cambio en el archivo aparezca enseguida como error de deserialización.

Notas y limitaciones

  • No se genera salida para Newtonsoft.Json ([JsonProperty]). Si usas Json.NET, cambia los atributos a [JsonProperty("key")].
  • Las cadenas de fecha se quedan como string. Para valores ISO 8601, basta con cambiar el tipo a DateTime o DateTimeOffset para que System.Text.Json los parsee.
  • El new() con tipo de destino y string? suponen C# 9+ con el contexto nullable activado (el valor por defecto desde .NET 6).
  • No se genera record ni required. Para modelos inmutables, cambia { get; set; } por { get; init; }.
  • Todas las clases salen en un solo bloque; la división en archivos y los namespaces corren de tu cuenta.

Preguntas frecuentes

¿Por qué añadir [JsonPropertyName] aunque la clave ya coincida?

System.Text.Json distingue mayúsculas por defecto. En proyectos de consola o worker sin JsonSerializerOptions personalizadas, paymentId no se vincularía a PaymentId, así que el atributo se escribe siempre para que funcione con cualquier configuración.

¿Cómo leo una propiedad JsonElement??

Comprueba ValueKind y luego usa GetString(), GetInt32() o Deserialize<T>(). Cuando conozcas el tipo real, sustituir JsonElement por él es la opción más limpia.

¿Puedo mantener los nombres de propiedad en camelCase?

La salida sigue la convención PascalCase de C#. La clave original está en [JsonPropertyName], así que puedes renombrar las propiedades libremente mientras el atributo se mantenga.

¿Funciona con JsonUtility de Unity?

JsonUtility solo maneja campos públicos de clases [Serializable], no propiedades, e ignora [JsonPropertyName]. En Unity, combina la salida con el paquete Newtonsoft.Json o con System.Text.Json.