JSON Swiss

JSON Swiss

Gerador de Struct Swift para JSON Schema

Entrada Código Swift

Carregando editor…

Saída JSON Schema

Configurações

Selecione qual struct/classe deve ser tratada como raiz do JSON Schema.

A análise ocorre inteiramente no seu navegador. Seu código não sai da página.

Cole seus modelos Swift para produzir JSON Schema instantaneamente.

Suporta structs Codable, tipos opcionais, arrays, dicionários e modelos aninhados.

Como converter structs em Swift para JSON Schema – guia passo a passo

Este conversor online de struct Swift para JSON Schema ajuda você a gerar JSON Schema a partir de modelos reais (DTOs, structs e classes) para validar payloads, compartilhar contratos e gerar JSON mock.

  1. Etapa 1 – Cole sua fonte em Swift

    • Cole os modelos que você quer documentar no editor à esquerda.
    • Inclua tipos referenciados no mesmo trecho para que o schema possa gerar definitions.
    • Use o botão Exemplo para carregar um exemplo e ver o formato de entrada esperado.

  2. Etapa 2 – Selecione o Tipo raiz (se necessário)

    • Se múltiplas definições forem detectadas, escolha a raiz que corresponde ao payload da sua API.
    • O schema de saída é construído em torno da raiz selecionada e pode incluir definições adicionais para tipos referenciados.

  3. Etapa 3 – Revise a saída do JSON Schema

    • Verifique tipos, campos obrigatórios vs opcionais e estruturas aninhadas de objeto/array.
    • Procure por definitions e $ref quando seus modelos referenciam outros modelos.
    • Copie ou baixe o schema para validação, documentação ou desenvolvimento schema-first.

  4. Etapa 4 – Valide ou gere JSON mock

    • Clique em Gerar dados mock para abrir o gerador de mock com seu schema pré-carregado.
    • Valide payloads reais contra o schema para detectar breaking changes cedo.
    • Se você depender de composição avançada de schema (por exemplo anyOf/oneOf/allOf), verifique o resultado com um validador completo como o Ajv.

Observação sobre suporte a keywords de schema

Schemas gerados podem incluir $ref e podem ser editados para incluir anyOf, oneOf, ou allOf. Para schemas complexos, use um validador completo de JSON Schema e faça dereference antes de gerar mock data, se necessário.

Ferramentas relacionadas de JSON Schema e geração de código

Use estas ferramentas para validar schemas, gerar payloads mock, formatar exemplos JSON e manter código e contratos alinhados.

Gerador de dados mock de JSON Schema

Gere JSON de exemplo a partir do seu schema para testes, fixtures e documentação.

Validador de JSON Schema

Valide JSON contra keywords comuns de schema e encontre inconsistências rapidamente.

JSON para Structs em Swift

Gere tipos e modelos em Swift a partir de exemplos JSON.

Gerador de JSON para JSON Schema

Crie schema a partir de exemplos JSON representativos para complementar schemas model-first.

Schema Library

Explore exemplos e padrões de schema para objetos, arrays, enums e constraints.

JSON Formatter

Limpe exemplos JSON antes de validar contra schema ou compartilhar documentação.

Perguntas Frequentes

Quais tipos Swift são suportados?

A ferramenta faz parse de structs e classes com stored properties. Ela lida com tipos opcionais (String?), arrays, dicionários, valores padrão, anotações Codable como @CodingKey (ignoradas, mas seguras) e tipos aninhados. Cole modelos diretamente do seu projeto Swift/SwiftUI.

Como tipos Swift são mapeados para JSON Schema?

String/Int/Double/Bool mapeiam para primitivas do schema, arrays como [Address] viram arrays no schema, dicionários viram objetos e tipos opcionais viram campos opcionais. Tipos custom desconhecidos viram string a menos que outra struct/classe com esse nome exista na entrada.

Posso incluir múltiplas structs?

Sim. Cole várias structs relacionadas e escolha o tipo raiz no dropdown de configurações. Tudo roda localmente no navegador, então nenhum código é enviado.

Como criar dados JSON mock?

Depois de gerar o schema, clique em "Gerar dados mock" para abrir o Mock Generator com o schema pré-carregado. Configure locale, quantidade em arrays e campos opcionais para criar payloads instantaneamente.

Gerador de Struct Swift para JSON Schema | JSONSwiss