Компрессор JSON OpenAPI / Swagger
Вставьте JSON-спецификацию OpenAPI 3.x или Swagger 2.0, чтобы удалить описания, примеры и x--расширения — уменьшает размер спецификации для пайплайнов генерации SDK и импорта в API-шлюзы. Работает полностью в вашем браузере, без регистрации.
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
Почему стоит использовать наш компрессор OpenAPI?
- Мгновенное сжатие спецификаций OpenAPI: вставьте любую JSON-спецификацию OpenAPI 3.x или Swagger 2.0 и сожмите её мгновенно в браузере — описания, примеры и x--расширения удаляются за миллисекунды.
- Безопасный онлайн-компрессор OpenAPI: ваша спецификация API никогда не покидает устройство. Всё сжатие выполняется локально в браузере: безопасно для внутренних или проприетарных спецификаций API с чувствительной информацией об эндпоинтах.
- Гибкие параметры сжатия: выбирайте, что именно удалять — описания, сводки, примеры, x--расширения, флаги deprecated или пробелы в JSON — с живым предпросмотром сжатого результата.
- 100 % бесплатно навсегда: сжимайте сколько угодно спецификаций OpenAPI совершенно бесплатно. Без аккаунта, без подписки, без ограничений размера файлов и без рекламы.
Что такое сжатие спецификаций OpenAPI?
Сжатие спецификаций OpenAPI — это удаление полей только для документации из JSON-спецификации OpenAPI, чтобы уменьшить её размер для программных сценариев, таких как генерация SDK, импорт в API-шлюзы и пайплайны CI/CD. Большие спецификации OpenAPI могут достигать нескольких мегабайт, когда включают многословные описания, встроенные примеры и поля расширений поставщика — ни одно из которых не нужно для генерации кода. Наш бесплатный компрессор OpenAPI удаляет эти поля в вашем браузере и показывает, что именно было удалено.
Как работает наш компрессор OpenAPI
- Вставьте спецификацию: скопируйте JSON-спецификацию OpenAPI 3.x или Swagger 2.0 и вставьте её на панель ввода. Нажмите кнопку с примером, чтобы загрузить образец спецификации.
- Выберите параметры сжатия: отметьте, какие поля удалить — описания, сводки, примеры, x--расширения, флаги deprecated или пробелы в JSON. Результат обновляется мгновенно.
- Скопируйте или скачайте: скопируйте сжатую спецификацию в буфер обмена или скачайте её как файл .json, а затем используйте в генераторе SDK или API-шлюзе.
Что удаляется во время сжатия
- Описания: все поля «description» из путей, операций, параметров, тел запросов, ответов и схем — только документация, генераторами не используются.
- Примеры: поля «example» и «examples» из схем и параметров — используются только для отображения документации.
- x--расширения: все поля-расширения поставщика, начинающиеся с x-: внутренние метаданные, добавленные инструментами управления API.
- Пробелы в JSON: все отступы, переводы строк и пробелы между токенами — даёт однострочный минифицированный JSON.
Что сохраняется
Все структурные поля, необходимые для генерации SDK и импорта в API-шлюзы, сохраняются полностью: пути, HTTP-методы, идентификаторы операций, параметры (name, in, required, schema), тела запросов, коды статуса ответов, схемы ответов, определения компонентов, схемы безопасности и URL серверов. Сжатая спецификация функционально идентична оригиналу для всех программных сценариев.
Часто задаваемые вопросы
Компрессор OpenAPI удаляет многословные поля, такие как описания, примеры и x--расширения, из JSON-спецификаций OpenAPI, чтобы уменьшить их размер для генерации SDK, импорта в API-шлюзы и пайплайнов CI/CD. Наш бесплатный онлайн-компрессор OpenAPI работает полностью в браузере: без регистрации и загрузки на сервер.
Нет. Генераторы SDK (OpenAPI Generator, Swagger Codegen, Kiota) используют только структурные поля: пути, операции, параметры, тела запросов, схемы ответов и определения компонентов. Описания и примеры — это поля только для документации, они не влияют на сгенерированный код.
Да, полная конфиденциальность гарантирована. Всё сжатие выполняется на стороне клиента в вашем браузере. Ваша спецификация OpenAPI, которая может содержать внутренние пути эндпоинтов, схемы аутентификации и проприетарные модели данных, никогда не покидает устройство и не загружается на сервер.
Да. Компрессор OpenAPI на 100 % бесплатный: без регистрации, без подписки, без ограничений размера спецификации и без рекламы. Вы можете сжать сколько угодно спецификаций.
В OpenAPI 3.x «summary» — это краткое однострочное описание операции (показывается в навигации по документации API), а «description» — более длинное объяснение в формате markdown. Оба являются полями только для документации: их удаление не влияет ни на генерацию SDK, ни на поведение API-шлюза.
Поля-расширения x- — это метаданные, специфичные для конкретного поставщика, которые добавляют инструменты управления API, шлюзы или внутренний инструментарий (например, x-rate-limit, x-internal-id, x-amazon-apigateway-integration). Их безопасно удалять для генерации SDK, но они могут требоваться для конкретных импортов в API-шлюзы. Проверьте документацию вашего шлюза перед удалением.
Да. Компрессор работает как со спецификациями JSON Swagger 2.0 (swagger: "2.0"), так и с OpenAPI 3.0/3.1 (openapi: "3.x.x"). Одни и те же поля (описания, примеры, x--расширения) есть в обоих форматах и удаляются по одной и той же логике.
Текущая версия компрессора поддерживает только вход JSON. Чтобы сжать спецификацию в YAML, сначала конвертируйте её в JSON с помощью конвертера YAML в JSON, а затем сожмите здесь.