主页 / 问题 / 1033102
Accepted
mkv
Asked:2020-10-10 15:07:17 +0000 UTC2020-10-10 15:07:17 +0000 UTC

Swagger，如何将对象属性放在界面中的单独字段中？

  • 772

是否可以在界面中的 Swagger 中将对象属性放在单独的字段中，如下面的屏幕截图所示？Swagger 版本 2.0 或 3.0。

以下是如何执行此操作的示例：

你需要把这样的属性

我只得到这个选项（版本 3.0 的代码）：

请求正文代码：

      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                example_obj:
                  type: object
                  properties:
                    field1:
                      type: string
                    from:
                      type: object
                      properties:
                        field2:
                          type: string
                    field3:
                      type: string

结果：

结果

更新：更详细的问题描述的屏幕截图。

更新

swagger

1 个回答

  1. Best Answer

    组件充当各种可重用定义的容器 - 模式（数据模型）、参数、响应、示例等

    paths:
  /xyz:
    post:
      tags:
        - Example
      summary: Example summary
      parameters:
      - in: header
        name: host
        description: Хост
        required: false
        schema:
          type: string
      requestBody:
        description: Example requestBody description
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/businessAddressRequest'
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/littlePony'

components:
  schemas:
    businessAddressRequest:
      type: object
      properties:
        uuid:
          type: string
          title: Uuid
        field:
          type: string
          title: Field title
      required:
        - field

    littlePony:
      type: object
      properties:
        uuid:
          type: string
          title: Uuid
        name:
          type: string
          title: lalala
      required:
        - name
    • 0

相关问题