¡Convierte JSON en data class de Kotlin!

¡Introduce JSON para generar código data class de Kotlin, incluidos los objetos anidados! Compatible con kotlinx.serialization @Serializable, @SerialName, Jackson.
JSON
Resultado
 

¡Convierte JSON en data class de Kotlin!

Pega la respuesta de una API o un JSON de configuración y obtén código Kotlin data class que refleja su estructura. Los objetos anidados y los arrays de objetos se convierten cada uno en su propia clase, y puedes elegir como destino kotlinx.serialization o Jackson.

Está pensado para el momento en que conectas una API externa en una app Android o en un servicio Ktor/Spring y quieres el esqueleto del modelo a partir de una respuesta de ejemplo en lugar de teclearlo. La conversión se ejecuta por completo en tu navegador, así que pegar la respuesta de una API interna no la envía a ningún sitio.

Cómo usar

  1. Pega JSON en el cuadro de entrada. Una respuesta real completa da mejor inferencia de tipos que una recortada.
  2. Pon en Nombre del tipo el nombre de la clase de nivel superior (por defecto Root), por ejemplo UserResponse.
  3. Elige kotlinx.serialization o Jackson en Serializador, según lo que ya use tu proyecto.
  4. Copia el código generado en tu archivo de modelos. El nombre del tipo y el serializador se guardan en la URL, así que un marcador reabre la misma configuración.

Ejemplo

Entrada (JSON)
{
  "orderId": "A-1024",
  "paid": true,
  "total": 39.9,
  "coupon": null,
  "items": [
    { "sku": "TSHIRT-M", "qty": 2 },
    { "sku": "CAP", "qty": 1, "gift_wrap": true }
  ]
}
Salida (Kotlin · kotlinx.serialization)
import kotlinx.serialization.Serializable
import kotlinx.serialization.SerialName
import kotlinx.serialization.json.JsonElement

@Serializable
data class Order(
    val orderId: String,
    val paid: Boolean,
    val total: Double,
    val coupon: JsonElement? = null,
    val items: List<Item>
)

@Serializable
data class Item(
    val sku: String,
    val qty: Int,
    @SerialName("gift_wrap") val giftWrap: Boolean? = null
)

Los objetos dentro del array items se convierten en una clase Item en singular, y gift_wrap, que solo aparece en el segundo elemento, pasa a Boolean? = null. coupon siempre vale null, así que su tipo no se puede inferir y se deja como JsonElement? para que lo sustituyas por el tipo real.

Funciones compatibles

  • kotlinx.serialization: @Serializable en cada clase, @SerialName en los campos cuyo nombre cambió, más los imports necesarios.
  • Jackson: @JsonProperty solo en los campos cuyo nombre cambió.
  • Las claves como user_name o home-url pasan a propiedades camelCase (userName, homeUrl) mapeadas a la clave original mediante una anotación.
  • Las palabras reservadas de Kotlin como class o val se envuelven entre backticks; las claves que empiezan por un dígito reciben el prefijo n.
  • Números: los enteros pasan a Int, los valores de más de 32 bits a Long, y cualquier decimal convierte el campo en Double.
  • Los arrays de objetos se fusionan en una clase a partir de todos los elementos; los campos presentes solo en algunos pasan a ? = null.
  • Un array o un primitivo de nivel superior produce un typealias, p. ej. typealias Root = List<RootItem>.

Casos de uso

Modelos de respuesta para clientes Retrofit o Ktor

Pega una respuesta copiada de Postman o de las DevTools del navegador y obtienes clases listas para Call<Order> o client.get<Order>(). Con respuestas de decenas de campos, evitas erratas y tipos equivocados al copiar a mano.

Mapear una API snake_case a la nomenclatura de Kotlin

Cuando el backend envía created_at, el lado Kotlin lee createdAt mientras el serial name conserva la clave original. El mapeo queda visible en cada clase en lugar de depender de una estrategia de nombres global.

Migrar a kotlinx.serialization

Si estás pasando modelos de Gson o Jackson a kotlinx.serialization, genera ambas salidas a partir del mismo JSON para ver exactamente qué anotaciones cambian.

Notas y limitaciones

  • Los tipos se infieren solo a partir del ejemplo que pegas. Un campo presente en todos los elementos del ejemplo sale como no nulo, así que añade tú el ? a los campos que la documentación de la API dice que pueden omitirse.
  • Las cadenas de fecha como 2024-01-01T00:00:00Z se quedan como String; pasar a Instant requiere tu propio serializer.
  • kotlinx.serialization no puede serializar Any, así que los valores sin tipo inferible pasan a JsonElement allí y a Any con Jackson.
  • No se generan enums, sealed classes ni valores por defecto (como listas vacías). Vale la pena convertir después en enums los campos con un conjunto fijo de valores.
  • Todas las clases salen en un solo bloque; las declaraciones de package y la división en archivos quedan de tu parte.

Preguntas frecuentes

¿Por qué un campo es String? = null y no solo String??

kotlinx.serialization lanza MissingFieldException cuando falta una clave y la propiedad no tiene valor por defecto. Añadir = null a los campos que faltan en algunos elementos o contienen null permite decodificar sin problemas las respuestas que no traen esa clave.

¿Puedo mantener las claves JSON como nombres de propiedad sin @SerialName?

La herramienta siempre convierte a camelCase y añade una anotación solo cuando el nombre difiere, así que las claves que ya están en camelCase salen sin anotaciones. Para mantener nombres snake_case, renombra las propiedades y quita las anotaciones después de generar.

¿Necesito jackson-module-kotlin si elijo Jackson?

Sí. La data class generada no tiene constructor sin argumentos, así que Jackson necesita tener registrado jackson-module-kotlin para vincular los valores a través de los parámetros del constructor (Spring Boot lo registra automáticamente cuando la dependencia está presente).

¿Puede generar modelos para Moshi o Gson?

Las opciones de serializador son kotlinx.serialization y Jackson. Para Gson, toma la salida de Jackson y sustituye @JsonProperty por @SerializedName; para Moshi, usa @Json(name = ...). La estructura de clases es la misma.