Показать информацию о проверке Swagger

Question

Swagger UI не показывает информацию о проверке параметров запроса.Я хочу показать минимальное значение параметра, максимальное значение, формат, шаблон (регулярное выражение).Кто-нибудь знает, как я выражаю информацию о проверке параметра в Swagger UI?

Answer 1

Используя openapi 3.0.0, я получил пользовательский интерфейс с информацией для проверки, подобной той, которая отображается в http://editor.swagger.io/. Преобразование из openapi 2 в openapi 3 можно выполнить по следующему URL.https://mermade.org.uk/openapi-converter

Answer 2

Если вы используете Swagger UI 3.x (последняя версия), добавьте showCommonExtensions: true к коду инициализации Swagger UI в вашем файле index.html:

const ui = SwaggerUIBundle({
  "dom_id": "#swagger-ui",
  url: "https://petstore.swagger.io/v2/swagger.json",
  showExtensions: true,    // <-----
  ...

Узнайте больше о SwaggerПараметры конфигурации интерфейса.