摇摇欲坠的YAML参数对象数组

时间:2020-11-09 18:53:47

标签: yaml swagger

我有一个REST端点,该端点接受和Id和一个对象作为输入参数。我已将其记录如下:

/api/examsession/end:
post:
  tags:
    - Exam
  summary: Bla bla
  operationId: api_exam_end
  description: Bla bla
  parameters:
    - in: query
      name: examSectionId
      description: Pass the identifier of the current Exam Section Session provided in the ResumeExamSectionResponse
      required: true
      schema:
        type: integer
        format: int32
    - in: query
      name: answers
      description: Pass the answer data. Only answered ones.
      required: true
      schema:
        type: array
        items:
          $ref: '#/components/schemas/ExamAnswerObject'
  responses:
    '200':
      description: Returns an object type of EndExamSectionResponse which return Exam Section information and score
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/EndExamSectionResponse'

我ewxpe3ct在参数定义旁边看到一个名为“ Schema”的链接,该链接将用户转到页面上的Schema定义,但是如图所示,没有指向已定义对象属性的链接。

DEF_screenshot

这里是否缺少任何内容,或者“参数”部分不允许这样的定义?

0 个答案:

没有答案