（Swagger 2.0/ Connexion）无类型不是“字符串”类型

Question

我正在尝试通过 python connexion 创建一个简单的帖子 API。这是我的 api yaml 文件：

swagger: "2.0"

info:
  title: "My first API"
  version: "1.0"

basePath: /v1.0

paths:
  /potential:
    post:
      operationId: api.data.create_potential_data
      summary: Create the potential data
      parameters:
        - name: alertCategory
          in: body
          required: True
          description: The potential API request AlertCategoryDto object with settings of alert category (categorySystemName, alert Kpis etc.)
          schema:
            $ref: "#/definitions/alert"
      responses:
        201:
          description: Successfully created potential data


definitions:
  alert:
    properties:
      systemName:
        type: string
      name:
        type: string
      moduleSystemName:
        type: string

但是对于name 属性之一，我们允许用户输入null 值。如果他们真的这样做，我们将得到error: None type is not of type 'string'

那么在 swagger 2.0 中是否有让属性可以为空的方法？网上找不到太多资料。谢谢！

Answer 1

我认为你应该写下 type: string 可为空：真

从这里我得到了信息 This link

应该是这样的：

definitions:
  alert:
    properties:
      systemName:
        type: string
      name:
        type: string
        nullable: true
      moduleSystemName:
        type: string

Answer 2

感谢@Danilo 的帮助，我在此处从 connexion 的文档中找到了答案：

总之，添加x-nullable = true 即可解决此问题。