Entrada JSON

Saída Swift

O que é JSON para Swift?

Construindo um app iOS ou macOS que chama uma REST API? Você receberá JSON — mas Swift precisa de structs Codable explícitos para decodificá-lo com segurança. Escrever esses structs à mão para cada endpoint de API é repetitivo e sujeito a erros. Esta ferramenta gera structs Swift automaticamente a partir do seu JSON, completo com conformidade Codable. Basta colar uma resposta de exemplo e você terá tipos prontos para JSONDecoder imediatamente.

A conversão roda no seu navegador. Você pode configurar o nome do struct e ativar Usar Codable e Tipos opcionais. Nada é enviado a um servidor. Os tipos gerados são um ponto de partida para projetos iOS, macOS ou Swift do lado do servidor.

Quando JSON para Swift ajuda

Ao desenvolver apps iOS ou macOS que consomem APIs REST, gere structs Codable aqui. Use JSONDecoder para fazer o parse. Cole uma resposta de exemplo para obter modelos tipados.

Como usar esta ferramenta

1

Colar ou enviar JSON

Cole seu JSON no editor esquerdo ou envie um arquivo. Use Amostra para dados de exemplo. Configure o Nome do struct raiz na configuração. Ative Usar Codable para conformidade Codable e Tipos opcionais para campos opcionais.

2

Revisar os tipos gerados

O painel direito mostra structs ou classes Swift. Objetos aninhados tornam-se tipos aninhados. Use JSONDecoder().decode(YourType.self, from: data) para fazer o parse. Adicione CodingKeys se as chaves JSON diferirem dos nomes das propriedades. Para JSON inválido, use primeiro o Validador JSON.

3

Copiar ou baixar

Use Copiar ou Baixar. Para formatar JSON primeiro, use o Formatador JSON. Para validação, use o Validador JSON.

Exemplos de JSON para Swift

Aqui está um exemplo de geração de structs Swift a partir de um objeto JSON.

Exemplo: Registro de assinante

Entrada JSON:

Entrada

Saída Swift gerada:

Saída

Quando JSON para Swift ajuda

Ao desenvolver apps iOS ou macOS que consomem APIs REST, você precisa de tipos Swift para o payload de resposta. Colar uma resposta de exemplo aqui fornece structs Codable para usar com URLSession ou Alamofire. Swift do lado do servidor (Vapor, Kitura) se beneficia do mesmo fluxo. Escrever structs manualmente para JSON aninhado complexo é propenso a erros; esta ferramenta infere a estrutura do seu exemplo. Para extrair valores específicos de respostas grandes primeiro, use jq na linha de comando. Para validação, use o Validador JSON.

Perguntas frequentes

O que é um struct Codable em Swift?

Codable é um typealias para Encodable & Decodable. Um struct Codable pode ser convertido para/de JSON usando o JSONDecoder e JSONEncoder integrados do Swift. É a forma moderna e recomendada de lidar com JSON em apps iOS e macOS. Veja o guia Codable da Apple.

Como decodifico JSON em Swift?

Crie um struct Codable que corresponda ao seu JSON, depois chame JSONDecoder().decode(YourType.self, from: data). Gere o struct aqui — cole seu JSON e copie o resultado para seu projeto Xcode.

Struct vs classe para modelos JSON em Swift?

Structs são tipos de valor e são preferidos para DTOs e modelos JSON em Swift — são mais simples, thread-safe e funcionam bem com Codable. Use classes quando precisar de semântica de referência ou herança.

Meus dados JSON são enviados para um servidor?

Não. A geração de structs é executada completamente no seu navegador. Seu JSON nunca sai do seu dispositivo, então é seguro para chaves API ou payloads sensíveis.

Posso usar isso com Alamofire?

Sim. O responseDecodable(of: YourType.self) do Alamofire funciona com qualquer tipo Codable. Gere o struct aqui e conecte direto ao seu handler de resposta do Alamofire.

Ferramentas relacionadas

Swift Codable. JSONDecoder. especificação JSON. RFC 8259. MDN.