¡Convierte clases de C# a JSON!

¡Pega código C# (class·record) y obtén un JSON de ejemplo! Compatible con System.Text.Json [JsonPropertyName], Newtonsoft.Json [JsonProperty]. Útil para documentar APIs y cuerpos de petición de prueba (mock request body).
C#
Resultado
 

¡Convierte clases de C# a JSON!

Pega modelos C# hechos con class, record o struct y obtén un documento JSON de ejemplo que sigue las reglas de System.Text.Json y Newtonsoft.Json. Elige entre la política de nombres camelCase que ASP.NET Core usa por defecto y los nombres de propiedad tal como están escritos; los nombres definidos con [JsonPropertyName] o [JsonProperty] siempre tienen prioridad.

Úsalo para pasar un ejemplo a un frontend o a un partner externo a partir de los modelos de petición/respuesta de una Web API, para rellenar los ejemplos de Swagger (Swashbuckle) o para preparar bodies para tests de integración con HttpClient.

Cómo usar

  1. Pega el código fuente del modelo. using, namespace, constructores y métodos pueden quedarse.
  2. Elige una Política de nombres: camelCase (predeterminado de ASP.NET Core) para proyectos Web API estándar, o Nombres de propiedad tal cual si configuras PropertyNamingPolicy = null o dependes de los valores por defecto de Newtonsoft.
  3. Con Tipo raíz en Automático, el primer tipo que ningún otro modelo referencia pasa a ser la raíz; cámbialo desde la lista si hace falta.
  4. Copia el JSON en un ejemplo de Swagger, un archivo .http o el body de una petición de xUnit. Las opciones elegidas se guardan en la URL.

Ejemplo

Entrada (C#)
public class InventoryItem
{
    public Guid Id { get; set; }
    public string SKU { get; set; } = "";
    [JsonPropertyName("stock_qty")]
    public int StockQuantity { get; set; }
    public StockState State { get; set; } = StockState.InStock;
    public DateTimeOffset UpdatedAt { get; set; }
    public List<string> Barcodes { get; set; } = new();
    [JsonIgnore]
    public string WarehouseNote { get; set; } = "";
    private int _version;
}

public enum StockState { InStock, LowStock, OutOfStock }
Salida (JSON · camelCase)
{
  "id": "00000000-0000-0000-0000-000000000000",
  "sku": "",
  "stock_qty": 0,
  "state": 0,
  "updatedAt": "1970-01-01T00:00:00+00:00",
  "barcodes": [
    ""
  ]
}

Con la política camelCase, un nombre todo en mayúsculas como SKU pasa a sku, igual que con JsonNamingPolicy.CamelCase de System.Text.Json, mientras que [JsonPropertyName("stock_qty")] mantiene su nombre sea cual sea la política. WarehouseNote ([JsonIgnore]) y el campo private _version quedan fuera. El enum State no tiene un converter a cadena, así que muestra 0, el valor numérico de su inicializador StockState.InStock.

Funciones compatibles

  • Atributos de renombrado: [JsonPropertyName] de System.Text.Json, [JsonProperty] de Newtonsoft y [DataMember(Name = ...)].
  • Solo se incluyen las propiedades y campos public, más los miembros no públicos marcados con [JsonInclude]. Se excluyen static, const, [JsonIgnore] e [IgnoreDataMember]; los ignores condicionales como Condition = WhenWritingNull se mantienen.
  • Se admiten los records posicionales (record Customer(long Id, string Name)) y los destinos [property: JsonPropertyName(...)].
  • Se incluyen las propiedades calculadas con cuerpo de expresión (=> ...), igual que las serializaría System.Text.Json.
  • Los enums se escriben como números, como hacen por defecto System.Text.Json y Newtonsoft (incluidos valores explícitos como = 10). Con [JsonConverter(typeof(JsonStringEnumConverter))] (o StringEnumConverter de Newtonsoft) en el enum o en la propiedad, o con [JsonStringEnumMemberName] / [EnumMember(Value = ...)] en los miembros, se usa en su lugar la cadena del nombre.
  • Fechas e IDs: DateTime → 1970-01-01T00:00:00, DateTimeOffset → 1970-01-01T00:00:00+00:00, DateOnly → 1970-01-01, TimeOnly/TimeSpan → 00:00:00, Guid → GUID todo ceros.
  • int?/Nullable<T> usan el tipo interior, List<T>/IEnumerable<T>/los arrays reciben un elemento, Dictionary<int, V> usa una clave "0", y object, JsonElement y JObject pasan a null.
  • Los inicializadores literales (= 1.5, = "KRW") se usan como valores de ejemplo.

Casos de uso

Alinear los ejemplos de Swashbuckle con las respuestas reales

Los DTOs que mezclan [JsonPropertyName] con la nomenclatura por defecto hacen que los ejemplos generados por Swagger UI se malinterpreten con facilidad. Usa esta salida en un ISchemaFilter o en un comentario XML <example> para que la documentación y la respuesta compartan las mismas claves.

Migrar de Newtonsoft a System.Text.Json

Alterna la Política de nombres sobre el mismo modelo para previsualizar cómo cambia el case de las claves después de la migración.

Comprobar el contrato entre un cliente Unity/MAUI y el servidor

Cuando cliente y servidor mantienen copias separadas de un modelo, genera JSON desde cada lado y compáralos para detectar rápido las diferencias en los nombres de las claves.

Notas y limitaciones

  • Un JsonStringEnumConverter registrado globalmente con AddJsonOptions en Program.cs no se ve en el código del modelo, así que los enums siguen saliendo como números. Para ver los nombres, añade [JsonConverter(typeof(JsonStringEnumConverter))] a la declaración del enum antes de pegar.
  • Los tipos de referencia nullable como string? reciben un ejemplo tipado, no null.
  • No se aplican los atributos [JsonConverter] personalizados distintos del converter de enums a cadena, el DefaultIgnoreCondition de JsonSerializerOptions ni las políticas snake_case (JsonNamingPolicy.SnakeCaseLower).
  • No se admite el polimorfismo mediante [JsonPolymorphic]/[JsonDerivedType]; solo se genera el tipo base declarado.

Preguntas frecuentes

¿Cuándo debo usar cada opción de Política de nombres?

ASP.NET Core Web API usa JsonSerializerDefaults.Web, que es camelCase. Una app de consola que llama a JsonSerializer.Serialize sin opciones, o Newtonsoft.Json con la configuración por defecto, conserva los nombres de propiedad, así que en esos casos elige Nombres de propiedad tal cual.

¿Por qué aparece una propiedad calculada como public string FullName => ...?

Tanto System.Text.Json como Newtonsoft.Json serializan las propiedades públicas con getter, así que las propiedades calculadas también acaban en las respuestas. Añade [JsonIgnore] si no quieres exportarlas.

[JsonPropertyName] en un parámetro posicional de un record no renombra la clave en runtime.

Sin un destino, el compilador aplica el atributo solo al parámetro del constructor. Esta herramienta reconoce ambas formas, pero para renombrar la propiedad serializada de forma fiable escribe [property: JsonPropertyName("...")].

¿Por qué los valores DateTime no llevan Z?

Un DateTime con DateTimeKind.Unspecified se serializa sin offset. Si necesitas un offset UTC explícito, DateTimeOffset produce la forma +00:00.