Compresor de JSON de OpenAPI / Swagger
Pega una especificación JSON de OpenAPI 3.x o Swagger 2.0 para eliminar descripciones, ejemplos y extensiones x-: reduce el tamaño de la especificación para pipelines de generación de SDK e importaciones en pasarelas de API. Se ejecuta por completo en tu navegador y sin registro.
Paste an OpenAPI 3.x or Swagger 2.0 JSON specification to remove descriptions, examples, and x- extensions - reduces spec size for SDK generation pipelines and API gateway imports. Runs entirely in your browser.
Compression Options
¿Por qué usar nuestro compresor de OpenAPI?
- Compresión de especificaciones OpenAPI instantánea: pega cualquier especificación JSON de OpenAPI 3.x o Swagger 2.0 y comprímela al instante en tu navegador: elimina descripciones, ejemplos y extensiones x- en milisegundos.
- Compresor de OpenAPI online seguro: tu especificación de API nunca sale de tu dispositivo. Toda la compresión se ejecuta localmente en el navegador: seguro para especificaciones internas o propietarias que contienen información sensible de endpoints.
- Opciones de compresión granulares: elige exactamente qué eliminar (descripciones, resúmenes, ejemplos, extensiones x-, indicadores deprecated o espacios en blanco del JSON) con una vista previa en vivo de la salida comprimida.
- 100 % gratis para siempre: comprime tantas especificaciones de OpenAPI como necesites, totalmente gratis. Sin cuenta, sin suscripción, sin límites de tamaño de archivo y sin anuncios.
¿Qué es la compresión de especificaciones OpenAPI?
La compresión de especificaciones OpenAPI es el proceso de eliminar campos solo de documentación de una especificación JSON de OpenAPI para reducir su tamaño en casos de uso programáticos como la generación de SDK, las importaciones en pasarelas de API y los pipelines de CI/CD. Las especificaciones OpenAPI grandes pueden llegar a varios megabytes cuando incluyen descripciones verbosas, ejemplos en línea y campos de extensión del proveedor, ninguno de los cuales es necesario para la generación de código. Nuestro compresor de OpenAPI gratis elimina estos campos en tu navegador y muestra exactamente qué se ha eliminado.
Cómo funciona nuestro compresor de OpenAPI
- Pega tu especificación: copia tu especificación JSON de OpenAPI 3.x o Swagger 2.0 y pégala en el panel de entrada. Usa el botón de ejemplo para cargar una especificación de muestra.
- Elige las opciones de compresión: selecciona qué campos eliminar (descripciones, resúmenes, ejemplos, extensiones x-, indicadores deprecated o espacios en blanco del JSON). La salida se actualiza al instante.
- Copia o descarga: copia la especificación comprimida al portapapeles o descárgala como archivo .json y úsala en tu generador de SDK o pasarela de API.
Qué se elimina durante la compresión
- Descripciones: todos los campos «description» de rutas, operaciones, parámetros, cuerpos de petición, respuestas y esquemas: solo documentación, no los usan los generadores.
- Ejemplos: los campos «example» y «examples» de esquemas y parámetros: se usan solo para renderizar documentación.
- Extensiones x-: todos los campos de extensión del proveedor que empiezan por x-: metadatos internos añadidos por las herramientas de gestión de API.
- Espacios en blanco del JSON: toda la indentación, los saltos de línea y los espacios entre tokens: produce una salida JSON minificada en una sola línea.
Qué se conserva
Todos los campos estructurales necesarios para la generación de SDK y las importaciones en pasarelas de API se conservan por completo: rutas, métodos HTTP, IDs de operación, parámetros (name, in, required, schema), cuerpos de petición, códigos de estado de respuesta, esquemas de respuesta, definiciones de componentes, esquemas de seguridad y URLs de servidor. La especificación comprimida es funcionalmente idéntica a la original para todos los casos de uso programáticos.
Preguntas frecuentes
Un compresor de OpenAPI elimina campos verbosos como descripciones, ejemplos y extensiones x- de las especificaciones JSON de OpenAPI para reducir su tamaño para la generación de SDK, las importaciones en pasarelas de API y los pipelines de CI/CD. Nuestro compresor de OpenAPI online gratis se ejecuta por completo en tu navegador: sin registro ni subidas a servidores.
No. Los generadores de SDK (OpenAPI Generator, Swagger Codegen, Kiota) solo usan los campos estructurales: rutas, operaciones, parámetros, cuerpos de petición, esquemas de respuesta y definiciones de componentes. Las descripciones y los ejemplos son campos solo de documentación que no afectan al código generado.
Sí, se garantiza la privacidad completa. Toda la compresión se ejecuta en el lado del cliente en tu navegador. Tu especificación de OpenAPI, que puede contener rutas internas de endpoints, esquemas de autenticación y modelos de datos propietarios, nunca sale de tu dispositivo y nunca se sube a ningún servidor.
Sí. El compresor de OpenAPI es 100 % gratis, sin registro, sin suscripción, sin límites de tamaño de especificación y sin anuncios. Puedes comprimir tantas especificaciones como necesites.
En OpenAPI 3.x, «summary» es una descripción breve de una línea de una operación (se muestra en la navegación de la documentación de la API), mientras que «description» es una explicación más larga con formato markdown. Ambos son campos solo de documentación: eliminarlos no tiene efecto en la generación del SDK ni en el comportamiento de la pasarela de API.
Los campos de extensión x- son metadatos específicos del proveedor que añaden las herramientas de gestión de API, las pasarelas o el tooling interno (por ejemplo, x-rate-limit, x-internal-id, x-amazon-apigateway-integration). Es seguro eliminarlos para la generación de SDK, pero pueden ser necesarios para importaciones concretas en pasarelas de API. Consulta la documentación de tu pasarela antes de eliminarlos.
Sí. El compresor funciona tanto con especificaciones JSON de Swagger 2.0 (swagger: "2.0") como de OpenAPI 3.0/3.1 (openapi: "3.x.x"). Los mismos campos (descripciones, ejemplos, extensiones x-) existen en ambos formatos y se eliminan con la misma lógica.
La versión actual del compresor solo admite entrada JSON. Para comprimir una especificación en YAML, conviértela primero a JSON con un conversor de YAML a JSON y luego comprímela aquí.