在 Swagger 中创建复杂类型（定义）

Question

我创建了一个名为 Product 的定义和另一个名为 Text 的定义（参见代码）。

在parameters 的paths 上，我不能使用在定义中创建的类型Text。在Product 的定义上，我有一个名为message 的属性，我希望该属性也是Text 类型。

(...)

paths:
  /products:
    get:
      summary: Product Types
      description: |
        Description text
      parameters:
        - name: latitude
          in: query
          description: Latitude component of location.
          required: true
          ### The type Text was not found here
          type: Text ### The type Text was not found here
(...)

definitions:

  Product:
    properties:
      message:
        ### The type Text was not found here
        type: Text ### Compilation Error in this line ####
      name:
        type: string
        description: Data description.


  Text:
    properties:
      code:
        type: string

但是出现这个错误：

招摇错误： 数据与“anyOf”中的任何模式都不匹配。

如何在Product 类型上引用Text 类型？

Answer 1

请改用$ref。这是一个例子

type: object
required:
- name
properties:
  name:
    type: string
  address:
    $ref: '#/definitions/Address'
  age:
    type: integer
    format: int32
    minimum: 0

参考：https://github.com/swagger-api/swagger-spec/blob/master/versions/2.0.md#simple-model