Swagger UI不会在模型中显示枚举值

Question

我在使用Swagger UI时遇到了一个小问题，我不确定它是否是一个错误...

我使用Swagger编辑器描述了我的API，并且我有一个包含枚举参数的方法。

现在，问题是：在生成的Swagger-UI文档中，在'model'选项卡中，我有一个'messageType'对象的空定义:(我想显示允许的值（BRAND，VISITOR，COMMENT和RESPONSE）

要重现的代码段：

swagger: '2.0'
info:
  version: 1.0.0-SNAPSHOT
  title: foo
  description: foo
host: dev.fr
basePath: /base
schemes:
  - http
  - https
consumes:
  - application/json
produces:
  - application/json

paths:
  /social/message:
    post:
      operationId: create
      responses:
        '201':
          schema:
            $ref: '#/definitions/message'
        'default':
          description: Default error response

definitions:
  message:
    required:
      - title
      - messageType
    properties:
      title:
        type: string
      messageType:
        $ref: '#/definitions/messageType'

  messageType:
    enum:
      - COMMENT
      - RESPONSE

有什么想法吗？我做错了吗？这是一个错误吗？ 非常感谢:)）

Answer 1

fehguy是对的，通过在我的对象上添加“type：string”来解决问题：）