Я хотел бы знать, возможно ли следующее. Swagger — это почти то, что мне нужно для документирования API на основе сообщений. Например, для Командного сообщения я хотел бы сказать "Команда" вместо "Опубликовать", и вместо «пути» я хотел бы...

Я следую первоочередному подходу к созданию REST API в стеке Java/Spring MVC. У меня есть написанная от руки схема Swagger, которую я хочу проверить в своей сборке Maven, и я хочу, чтобы эта сборка завершилась ошибкой, если схема не соответствует...

✖ Swagger Error Equivalent path already exists: /profile/address/{id} ✖ Swagger Error Equivalent path already exists: /profile/qualifications/{id} В редакторе Swagger я получаю эту ошибку. Если вы видите ... пути разные ... даже если он выдает...

В примере редактора Swagger, http://editor.swagger.io/#/ , есть Раздел «Модели» позже в отображаемом документе после отображения конечных точек. Является ли это только функцией этого редактора, чтобы увидеть, как выглядят вещи, которые вы...

Я ищу элегантный способ определить API, который может использовать данные JSON, а также данные формы. Следующий фрагмент работает, но он не элегантен и требует уродливого кода в бэкенде. Есть ли лучший способ определить это? Что сейчас работает:...

Пользовательский интерфейс Swagger генерирует неправильную команду Curl, как вставлено ниже, и из-за усечения этой строки запроса curl -X GET http://domain:8080/v1/endpoint?access_token=affsfafasfa&type=1 -H "принять: приложение/json" -H "тип...

Есть ли еще создатель документации Swagger на основе аннотаций для Vert.x? Все остальные конечные точки управляются с помощью маршрутизаторов, и поэтому, если есть какой-либо способ создать документацию Swagger, это было бы здорово. Я просмотрел...

Я хочу получить доступ к https://editor.swagger.io/ , но мне нужно, чтобы файл YAML был предварительно загружен на основе в параметре URL. Поэтому, если я хочу просмотреть...

У меня есть следующее определение OpenAPI YAML. Раздел externalDocs находится под разделом servers , но отображается перед сервером в предварительном просмотре в редакторе Swagger ( https://editor.swagger.io/ ). Почему это? openapi: 3.0.0...

Я вручную пишу чванливую документацию. Но у меня ошибка Should be object Я не знаю, почему я получаю ошибку в приведенном ниже коде. events: $ref: "#/def/Events" Events: type: "object" properties: oneOf: -...

В моем файле oas.yaml есть следующее: components: schemas: ServiceError: type: object properties: Message: type: string description: "The exception message." ExceptionMessage: type:...

Я использую онлайн-редактор Swagger для документации нашего проекта API. Сам проект размещен в нашем собственном экземпляре Gitlab, защищенном аутентификацией и разрешениями. Пример URL-адреса для аутентифицированных и авторизованных...

Можно ли из редактора Swagger сохранить изменения или правки обратно в исходный импортированный файл? В настоящее время я сохраняю код в виде файла yaml, выполняю сравнение в Intellij, принимаю каждое изменение, а затем сохраняю этот файл. В лучшем...