flask - Flasgger：参数未显示和架构

Question

我最近开始学习 Swagger 的 APi 文档。但是，当我转到 localhost:5000/apidocs 时，我看到了我添加的 API，但即使我在 yml 文件中描述了参数，所有 API 都没有参数。我在互联网上找不到任何相关的东西。

这是我的 YML 代码：

paths:
  /api/ppp:
    get:
      tags:
      - "user"
      summary: "Find User by uID"
      description: "Returns a single user info"
      operationId: "getuserById"
      produces:
        - "application/xml"
        - "application/json"
      parameters:
        - name: "userId"
          in: "path"
          description: "ID of user to return"
          required: true
          type: "uuid"

这就是我如何将招摇添加到 api @swag_from('pathto/swagger.yml')

同样，我还有一个疑问。我们在 yml 规范文件中定义模式。我想知道这些模式到底代表什么，是否有必要使用它们？

附件是 APIdocs 页面的截图

Answer 1

尝试这个：

tags:
- user
summary: "Find User by uID"
description: "Returns a single user info"
operationId: "getuserById"
produces:
  - "application/xml"
  - "application/json"
parameters:
  - name: "userId"
    in: "path"
    description: "ID of user to return"
    required: true
    type: "uuid"