utkuozan
5 years agoNew Member
How can I define and reference an array of object as a parameter
I have a REST endpoint which accepts and Id and an object as input parameter. I have documented it as follows :
/api/exam/end:
post:
tags:
- Exam
summary: Bla bla
operationId: exam_end
description: Bla bla
parameters:
- in: query
name: sectionId
description: Bla bla
required: true
schema:
type: integer
format: int32
- in: query
name: answers
description: Bla bla
required: true
schema:
type: array
items:
$ref: '#/components/schemas/ExamAnswerObject'
responses:
'200':
description: Bla bla
content:
application/json:
schema:
$ref: '#/components/schemas/EndExamSectionResponse'
I also have a valid definition for "ExamAnswerObject" where it is correctly displayed in the Schemas section. The problem is the document does not have a "Schema" link as it has in other parts.
IS there anything I am missing here or the "parameters" part does not allow such definition?
utkuozan wrote:IS there anything I am missing here or the "parameters" part does not allow such definition?
Your definition is correct, but Swagger UI currently does not display the schemas of object parameters. This issue is tracked here:
https://github.com/swagger-api/swagger-ui/issues/4581