Конвертер OpenAPI v2 в v3

Конвертер OpenAPI v2 в v3

Вставьте спецификацию Swagger 2.0 и получите валидную версию OpenAPI 3.0.3 в формате JSON или YAML. Конвертер применяет официальные правила структурного соответствия — перемещает definitions под components/schemas, сжимает host, basePathи schemes в servers, разбивает consumes и produces на отдельные операции content мапы и перестраивает параметры формы и определения безопасности — таким образом, ваша спецификация будет работать с современными инструментами OpenAPI.

Как использовать

1. Вставьте свою спецификацию Swagger 2.0 в поле ввода. Поддерживается как JSON, так и YAML; формат автоматически определяется.
2. Выберите формат вывода: сохранить исходный формат или принудительно использовать JSON или YAML.
3. Оставить Исправление отсутствующих обязательных полей для автоматического заполнения обязательных полей версии 3, таких как info.title, info.version, и отсутствующих описаний ответов, когда исходный формат версии 2 не включает их.
4. Просмотрите обзор конверсии и любые предупреждения, показанные выше результата, затем скопируйте или загрузите полученный OpenAPI 3.0.3 спецификацию.

Возможности

• Вход в формате JSON и YAML, выход в формате JSON или YAML — выберите предпочитаемый формат или сохраните формат входа.
• Структурное соответствие — definitions → components/schemas, securityDefinitions → components/securitySchemes, parameters/responses перемещаются под components, и каждый $ref указатель переписывается для соответствия.
• Серверы из host, basePath, schemes — объединяются в массив v3 servers с предпочтением HTTPS при наличии нескольких схем.
• Контент-неготиация — consumes и produces переводятся в отдельные операции requestBody.content и responses[*].content мапы.
• Параметры тела и формы — in: body становятся полем v3 requestBodyи in: formData полей группируются в схему тела запроса. multipart/form-data или application/x-www-form-urlencoded Запроса.
• Обновление потока безопасности — значения OAuth2 flow переписываются на объект v3 flows (/implicit, password, clientCredentials, authorizationCode).
• Режим исправления — при включении заполняет отсутствующие обязательные поля, чтобы выходной формат проходил проверку v3 вместо того, чтобы не проходить из-за незначительных дефектов исходного формата.
• Обзор конверсии и предупреждения — количество преобразованных путей, схем и схем безопасности, а также предупреждения относительно того, что не может быть преобразовано один к одному.
• Работает полностью в браузере — ваша спецификация никогда не покидает страницу.