显示 Swagger 验证信息

Question

Swagger UI 不显示请求参数的验证信息。我想显示参数的最小值，最大值，格式，模式（正则表达式）。有谁知道我在Swagger UI上表达参数验证信息的方式吗？

Answer 1

通过使用openapi 3.0.0，我得到了一个UI，其中包含 http://editor.swagger.io/ 中显示的验证信息。从 openapi 2 到 openapi 3 的转换可以在以下 URL 完成。https://mermade.org.uk/openapi-converter

Answer 2

假设您使用Swagger UI 3.x(最新版本)，将< code > showCommonExtensions:true 添加到< code>index.html文件中的Swagger UI初始化代码:

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

了解有关Swagger UI配置参数的更多信息。