Conversor bidirecional de OpenAPI 3.0 e 3.1
Conversor bidirecional de OpenAPI 3.0 e 3.1: Atualiza a versão raiz para 3.1.0 e converte OpenAPI 3.0 herdado `nullable: true` para `type: [string, 'null']`.
Sobre conversor bidirecional de openapi 3.0 e 3.1
Conversor bidirecional de OpenAPI 3.0 e 3.1：Conversor bidirecional de OpenAPI 3.0 e 3.1: Atualiza a versão raiz para 3.1.0 e converte OpenAPI 3.0 herdado `nullable: true` para `type: [string, 'null']`.
Como esta ferramenta funciona
Lê objeto JSON ou YAML. Apenas segundo campo exatamente `3.0` seleciona `3.0.3`; qualquer outro seleciona `3.1.0`. JSON volta formatado e YAML volta como YAML.
Pipeline de processamento e arquitetura técnica：
- Recepção léxica e normalização de dados no buffer de memória local.
- Validação de sintaxe estrutural e verificação de invariantes e limites de domínio.
- Transformação algorítmica determinística e cálculo matemático de alta precisão.
- Serialização do resultado verificado, verificação de integridade e geração de diagnósticos.
Exemplo e aplicação prática
Cenário de aplicação prática: Atualizar documento OpenAPI JSON para destino 3.1.
Entrada de amostra:
Processamento computacional: Definir versão raiz e dialeto Draft 2020-12.
Saída ilustrativa:
Limites e casos especiais
Para 3.1 troca recursivamente `nullable: true` por type contendo `null` e altera limites exclusivos booleanos com limite numérico. Para 3.0 volta arrays type com null para nullable.
Processamento no navegador e privacidade
A função da ferramenta foi projetada para processar a entrada no navegador sem enviá-la intencionalmente a um servidor de processamento do CZOA. Solicitações de recursos do site, análises ou publicidade são independentes. O navegador, suas extensões e o software gerenciado do dispositivo ficam fora desse limite.
Execução local e metodologia de verificação
O processamento da carga útil desta ferramenta foi projetado para ocorrer localmente no navegador por meio de JavaScript ou Web Workers. Solicitações de recursos do site, análises ou publicidade são independentes. Confidencialidade, repetibilidade e latência dependem do ambiente do navegador e não são garantidas de forma absoluta.
Normas técnicas e especificações de conformidade
Responsável pelo conteúdo: CZOA Tools · Última revisão: 2026-09-15 · Metodologia de revisão
Como usar
- Informe os dados ou selecione um arquivo compatível na área de trabalho.
- Confira os controles e escolha os parâmetros, unidades, formatos ou intervalos disponíveis.
- Clique no botão de ação ou consulte o cálculo imediato.
- Confira os diagnósticos e o resultado antes de copiar ou exportar.
Perguntas frequentes
Como OpenAPI Version Converter escolhe o destino?+
Lê objeto JSON ou YAML. Apenas segundo campo exatamente `3.0` seleciona `3.0.3`; qualquer outro seleciona `3.1.0`. JSON volta formatado e YAML volta como YAML.
O que mostra a fixture 3.1?+
Um JSON com `openapi: 3.0.3` passa para `openapi: 3.1.0` e ganha `jsonSchemaDialect: https://json-schema.org/draft/2020-12/schema`. A fixture verifica esses campos, não a especificação inteira.
Quais mudanças de schema existem?+
Para 3.1 troca recursivamente `nullable: true` por type contendo `null` e altera limites exclusivos booleanos com limite numérico. Para 3.0 volta arrays type com null para nullable.
O que ele não migra nem valida?+
Não exige chaves raiz, valida origem ou resultado, resolve referências, preserva comentários ou aliases YAML, informa perdas, limita profundidade, prova equivalência semântica ou cobre todas as diferenças OpenAPI.