在 Swagger 中创建我自己的类型答案

【问题标题】：Create my own type in Swagger在 Swagger 中创建我自己的类型
【发布时间】：2015-09-09 12:55:49
【问题描述】：

我有这个 swagger 的 YAML 代码，我需要创建自己的类型（名为 MyOwnType）。

如果我使用“MyOwnType”，则会出现编译错误。

paths:
  /in/total:
    get:
      summary: My summary.
      description: My description.

      parameters:
        - name: total
          in: query
          description: Total.
          required: true
          type: MyOwnType # -- THIS LINE OCCURS ERROR --
          format: MyOwnType
      responses:
        201:
          description: Respose
          schema:
            $ref: '#/definitions/MyOwnType'

definitions:
  MyOwnType:
    properties:
      var:
        type: string
        description: data.

我创建了一个定义“MyOwnType”，我可以像这样在架构中使用：“$ref: '#/definitions/MyOwnType'”。

但是如何在参数类型上使用“MyOwnType”定义？

【问题讨论】：

标签： swagger swagger-2.0 swagger-editor

【解决方案1】：

查询参数不能有 JSON 架构。如果您想为参数设置架构，则应将参数的 in 更改为 body 或 formData 并使用 schema 键：

swagger: '2.0'
info:
  version: 0.0.0
  title: '<enter your title>'
paths:
  /in/total:
    get:
      summary: My summary.
      description: My description.

      parameters:
        - name: total
          in: body
          description: Total.
          required: true
          schema:
            $ref: '#/definitions/MyOwnType'
      responses:
        201:
          description: Respose
          schema:
            $ref: '#/definitions/MyOwnType'

definitions:
  MyOwnType:
    properties:
      var:
        type: string
        description: data.

【讨论】：