Swagger не отображает свойства объекта в пользовательском интерфейсе

Question

Я делаю документацию для API.
На данный момент у меня есть:

/script/update:
post:
  tags: 
  - "Script"
  summary: Update a script
  operationId: updateScript
  responses:
    '200':
      description: OK
    "404":
      description: Not Found
  requestBody:
    description: A script object in order to make the request
    required: true
    content:
      application/x-www-form-urlencoded:
        schema:
          type: object
          properties:
            subsite_id:
              type: string
            script:
              type: object
              properties:
                script:
                  $ref: '#/components/schemas/ScriptType'
                type:
                  type: string
                  enum:
                    - custom
                    - interface
                    - freshbot
                    - feeder
                    - getter
                    - smcf
                status:
                  $ref: '#/components/schemas/ScriptStatus'
                comment:
                  type: string
                  format: string
                reason:
                  type: string
                  format: string

Проблема возникает, когда я пытаюсь использовать пользовательский интерфейс. Единственное, что появляется, это следующее: Я хочу, чтобы объект сценария можно было заполнять поле за полем для каждого из свойств, таких как subsite_id. Чего мне не хватает

Answer 1

Swagger UI 3.x не имеет редактора форм для объектов JSON, поэтому все данные JSON необходимо вводить в формате JSON: { "prop": value, ... }

Вот соответствующий запрос функции, который вы можете отслеживать:
https://github.com/swagger-api/swagger-ui/issues/2771