JSON para Swift Struct Online

Gere structs Swift Codable a partir de JSON, grátis, no seu navegador.

Class name:

JSON

Swift Struct

struct Address: Codable {
    let city: String
    let zip: String
}

struct User: Codable {
    let name: String
    let age: Int
    let skills: [String]
    let address: Address
}

Processed in your browser

Para que serve

De JSON para Swift Codable Struct

Pronto para iOS e SwiftUI

Gera structs compatíveis com URLSession, Alamofire, SwiftUI e Combine. Cole diretamente no Xcode.

100% privado

Seu JSON de API nunca sai do seu navegador. Sem cadastro, sem telemetria.

Codable correto

CodingKeys automático para snake_case, Optional para nullable, tipos corretos (Int, Double, Bool). Código idiomático.

Instantâneo

Structs gerados em tempo real enquanto você digita. Sem botões, sem esperas.

Como funciona

Três passos, sem complicação

Cole seu JSON

Cole o JSON da sua API ou resposta web. Funciona com objetos aninhados, arrays e qualquer estrutura JSON válida.

Geração instantânea

A ferramenta gera structs Swift conformes ao protocolo Codable automaticamente, com CodingKeys quando necessário.

Copie o código

Copie as structs geradas e use-as diretamente no seu projeto iOS, macOS ou SwiftUI.

Perguntas frequentes

Ficou com dúvidas?

O que é o protocolo Codable?

Codable é um alias de tipo introduzido no Swift 4 (WWDC 2017) que combina dois protocolos: Encodable (pode ser convertido para um formato externo como JSON) e Decodable (pode ser criado a partir de um formato externo). Um tipo conforme ao Codable pode tanto serializar quanto desserializar dados. A conformidade é obtida automaticamente via síntese do compilador se todas as propriedades também forem conformes ao Codable.

Struct vs class em Swift?

Para modelos de dados JSON, structs são preferidas por vários motivos: structs são value types (copiam em vez de referenciar), evitando problemas de estado compartilhado; o compilador pode otimizá-las melhor; e no SwiftUI, structs funcionam melhor com o modelo de dados reativo. Classes (reference types) têm seu lugar quando você precisa de herança ou identidade de objeto, mas para modelos de API structs são a prática recomendada.

Para que serve o enum CodingKeys?

CodingKeys é um enum aninhado que mapeia nomes de propriedades Swift para nomes de chaves no JSON. É necessário quando os nomes JSON (tipicamente snake_case em APIs REST) diferem das convenções Swift (camelCase). Por exemplo, se o JSON tem first_name, o CodingKey mapeia essa chave para o campo firstName da struct. Sem CodingKeys, Swift exige que os nomes JSON correspondam exatamente aos nomes das propriedades.

Como propriedades Optional são tratadas?

Em Swift, um tipo Optional (marcado com ?) pode ter um valor ou ser nil. Quando um campo JSON pode estar ausente ou ser null, a propriedade da struct é declarada como Optional: var email: String? em vez de var email: String. O JSONDecoder do Foundation trata a desserialização automaticamente: se a chave estiver ausente do JSON ou seu valor for null, a propriedade é definida como nil sem lançar um erro.

Como integro isso com URLSession?

O fluxo típico com URLSession e Codable é: URLSession.shared.dataTask retorna Data; JSONDecoder().decode com o tipo da struct e os dados converte os dados para a struct; o resultado é usado na UI na thread principal. Com Swift 5.5+ e async/await, use let data = try await URLSession.shared.data(for: request) seguido de let objeto = try JSONDecoder().decode com o tipo e os dados. Esse padrão é a base de toda integração de API no iOS moderno.