Conversor bidireccional de OpenAPI 3.0 y 3.1
Conversor bidireccional de OpenAPI 3.0 y 3.1: Actualiza la versión raíz a 3.1.0 y convierte OpenAPI 3.0 heredado `nullable: true` a `type: [string, 'null']`.
Acerca de conversor bidireccional de openapi 3.0 y 3.1
Conversor bidireccional de OpenAPI 3.0 y 3.1：Conversor bidireccional de OpenAPI 3.0 y 3.1: Actualiza la versión raíz a 3.1.0 y convierte OpenAPI 3.0 heredado `nullable: true` a `type: [string, 'null']`.
Cómo funciona esta herramienta
El módulo de API procesa especificaciones OpenAPI 3.0/3.1 y JSON Schema Draft 2020-12, expandiendo esquemas $ref y generando manifiestos para el Model Context Protocol (MCP).
Canalización de procesamiento y arquitectura técnica：
- Recepción léxica y normalización de la entrada en el búfer de memoria local.
- Validación de sintaxis estructural y verificación de invariantes y límites de dominio.
- Transformación algorítmica determinista y cálculo matemático de alta precisión.
- Serialización del resultado verificado, comprobación de integridad y generación de diagnósticos.
Ejemplo y aplicación práctica
Escenario de aplicación práctica: Actualizar un documento OpenAPI JSON al destino 3.1.
Entrada de muestra:
Procesamiento computacional: Fijar versión raíz y dialecto Draft 2020-12.
Salida ilustrativa:
Límites y casos especiales
Para 3.1 reemplaza recursivamente `nullable: true` por un type que contiene `null` y cambia límites exclusivos booleanos con límite numérico. Para 3.0 devuelve arrays type con null a nullable.
Procesamiento en el navegador y privacidad
La función de la herramienta está diseñada para procesar la entrada en el navegador sin enviarla intencionadamente a un servidor de procesamiento de CZOA. Las solicitudes de recursos del sitio, analítica o publicidad son independientes. El navegador, sus extensiones y el software administrado del dispositivo quedan fuera de este límite.
Ejecución local y metodología de verificación
El procesamiento de la carga útil de esta herramienta está diseñado para ejecutarse localmente en el navegador mediante JavaScript o Web Workers. Las solicitudes de recursos del sitio, análisis o publicidad son independientes. La confidencialidad, la repetibilidad y la latencia dependen del entorno del navegador y no se garantizan de forma absoluta.
Normas técnicas y especificaciones de conformidad
Responsable del contenido: CZOA Tools · Última revisión: 2026-09-15 · Metodología de revisión
Cómo se usa
- Introduce los datos o selecciona un archivo admitido en el espacio de trabajo.
- Revisa los controles y elige los parámetros, unidades, formatos o intervalos disponibles.
- Pulsa el botón de acción o consulta el cálculo inmediato.
- Comprueba los diagnósticos y el resultado antes de copiarlo o exportarlo.
Preguntas frecuentes
¿Cómo elige el destino OpenAPI Version Converter?+
Lee un objeto JSON o YAML. Solo el segundo campo exactamente `3.0` elige `3.0.3`; cualquier otro elige `3.1.0`. JSON devuelve JSON formateado y YAML devuelve YAML.
¿Qué muestra la fixture 3.1?+
Un documento JSON con `openapi: 3.0.3` pasa a `openapi: 3.1.0` y gana `jsonSchemaDialect: https://json-schema.org/draft/2020-12/schema`. La fixture verifica esos campos, no toda la especificación.
¿Qué cambios de schema implementa?+
Para 3.1 reemplaza recursivamente `nullable: true` por un type que contiene `null` y cambia límites exclusivos booleanos con límite numérico. Para 3.0 devuelve arrays type con null a nullable.
¿Qué no migra ni valida?+
No exige claves raíz, valida origen o resultado, resuelve referencias, conserva comentarios o alias YAML, informa pérdidas, limita profundidad, demuestra equivalencia semántica ni cubre todas las diferencias OpenAPI.