¡Convierte JSON en Codable struct de Swift!

¡Introduce JSON para generar código Codable struct de Swift, incluidos los objetos anidados! Compatible con Codable, CodingKeys, JSONDecoder, iOS.
JSON
Resultado
 

¡Convierte JSON en Codable struct de Swift!

Convierte JSON en structs de Swift que adoptan Codable. Las propiedades se declaran con let y se renombran a camelCase, y solo se genera un enum CodingKeys en los structs donde algún nombre difiere de su clave JSON.

Úsalo cuando una app de iOS o macOS necesita un modelo para decodificar con JSONDecoder una respuesta de URLSession, o cuando quieres tipos que coincidan con el JSON mock que hay detrás de una preview de SwiftUI.

Cómo usar

  1. Pega el body de una respuesta de tu API, por ejemplo una capturada con Proxyman o Charles.
  2. Pon en Nombre del tipo el nombre del struct de nivel superior (por ejemplo EpisodePage).
  3. Pega el resultado en un archivo Swift; import Foundation ya está incluido.
  4. Decodifica con try JSONDecoder().decode(EpisodePage.self, from: data).

Ejemplo

Entrada (JSON)
{
  "podcast": "Swift Talk",
  "episodes": [
    { "id": 301, "title": "Async Sequences", "duration": 1840, "explicit": false },
    { "id": 302, "title": "Macros", "duration": 2215.5, "explicit": false, "guest_name": "Chris" }
  ],
  "total_count": 2
}
Salida (Swift · Codable)
import Foundation

struct EpisodePage: Codable {
    let podcast: String
    let episodes: [Episode]
    let totalCount: Int

    enum CodingKeys: String, CodingKey {
        case podcast
        case episodes
        case totalCount = "total_count"
    }
}

struct Episode: Codable {
    let id: Int
    let title: String
    let duration: Double
    let explicit: Bool
    let guestName: String?

    enum CodingKeys: String, CodingKey {
        case id
        case title
        case duration
        case explicit
        case guestName = "guest_name"
    }
}

Los elementos del array episodes pasan a ser un struct Episode. duration mezcla un entero (1840) y un decimal (2215.5), así que es Double; guest_name, que solo aparece en el segundo episodio, es guestName: String?. Cualquier struct con un campo renombrado recibe un enum CodingKeys que lista todas sus claves.

Funciones compatibles

  • Todos los structs adoptan Codable; las propiedades son let inmutables.
  • Las claves snake_case y kebab-case pasan a propiedades camelCase, y solo entonces se añade enum CodingKeys: String, CodingKey con las claves originales.
  • Tipos: String, Int, Double, Bool y [T] para arrays.
  • Los campos que faltan en algunos elementos o contienen null son Optionals (String?), así que las claves ausentes se siguen decodificando.
  • Los valores de tipo mixto usan un enum JSONValue generado y decodificable.
  • Las palabras reservadas de Swift como default, class o self se envuelven entre backticks.
  • Un array de nivel superior produce typealias Root = [RootItem].

Casos de uso

URLSession con async/await

A partir de una sola respuesta de ejemplo obtienes un modelo que puedes decodificar en la línea siguiente a let (data, _) = try await URLSession.shared.data(from: url).

Pantallas de lista en SwiftUI

Añade Identifiable al struct generado (cuando tenga un campo id) y pásalo directamente a List(page.episodes) { ... }.

Datos mock incluidos en la app

Incluye en el bundle de la app el JSON de ejemplo de la fase de diseño y decodifícalo con el mismo modelo, para poder construir las pantallas antes de que la API real esté lista.

Notas y limitaciones

  • Las fechas en forma de cadena se quedan como String. Para obtener Date, cambia el tipo de la propiedad y configura una estrategia como decoder.dateDecodingStrategy = .iso8601.
  • Si falta en una respuesta la clave de una propiedad no opcional, la decodificación lanza DecodingError.keyNotFound. Añade ? a los campos que la API puede omitir, aunque tu ejemplo siempre los tuviera.
  • Todas las propiedades son let; cámbialas a var en los modelos que modifiques como estado de la vista.
  • No se adoptan protocolos adicionales como Identifiable o Hashable.
  • El enum JSONValue es código auxiliar para tipos mixtos; si tu proyecto ya tiene un tipo equivalente, bórralo y usa el tuyo.

Preguntas frecuentes

Con keyDecodingStrategy = .convertFromSnakeCase, ¿puedo borrar los CodingKeys?

Sí, en ese caso el decoder convierte guest_name ↔ guestName por ti. Pero no combines ambas cosas: el decoder convierte primero las claves a camelCase y luego las compara con el raw value "guest_name" de CodingKeys, así que la coincidencia falla.

¿Por qué structs y no clases?

Tratar los modelos de respuesta como tipos de valor es la convención habitual en Swift, y los structs obtienen gratis un inicializador memberwise, lo que facilita construir datos de prueba. Si necesitas semántica de referencia, cambia a final class y añade un inicializador.

Un campo que esperaba entero salió como Double.

Cuando una clave contiene tanto enteros como decimales, Double evita perder precisión. Al revés, si todos los valores del ejemplo son del tipo 4.0, el parser JSON del navegador los lee como enteros y puedes obtener Int, así que comprueba los valores reales de la API.

¿Al codificar de vuelta a JSON se conservan las claves originales?

Los CodingKeys también se usan al codificar, así que JSONEncoder vuelve a escribir guest_name. Las propiedades opcionales que valen nil se omiten en la salida.