In my raml definition I have an endpoint with query parameters described as follows:
queryParameters:
financial_documents:
description: list of financial document to get information in the format ["type,series,doc,statusflag","type2,series2,doc2,statusflag2"]
type: array
items: ATDFinancialDocumentKey
minItems: 1
maxItems: 15
example: |
[{"type":"REC","series":"REC2017","number":"1","statusFlag":"C"}]
when converting to oas20 I get the following:
"parameters": [
{
"minItems": 1,
"maxItems": 15,
"description": "list of financial document to get information in the format [\"type,series,doc,statusflag\",\"type2,series2,doc2,statusflag2\"]",
"type": "array",
"items": {
"type": "string"
},
"in": "query",
"name": "financial_documents",
"required": true
}
]
Is this the default behaviour? I would expect the financial_documents query parameter to be converted with a reference to a definition. Something like:
"parameters": [
{
"minItems": 1,
"maxItems": 15,
"description": "list of financial document to get information in the format [\"type,series,doc,statusflag\",\"type2,series2,doc2,statusflag2\"]",
"type": "array",
"items": {
"$ref": "#/definitions/ATDFinancialDocumentKey"
},
"in": "query",
"name": "financial_documents",
"required": true
}
]
In my raml definition I have an endpoint with query parameters described as follows:
when converting to oas20 I get the following:
Is this the default behaviour? I would expect the financial_documents query parameter to be converted with a reference to a definition. Something like: