Forum Discussion

yym's avatar
yym
New Contributor
3 years ago

Using $ref in query parameters definition in OAS

Hi All. I see that we can use $ref for Common Parameters for Various Paths but is it possible to use the same approach for query parameters? Background: our data models are quite large and rich in ...
chichepo's avatar
chichepo
Frequent Contributor
3 years ago

Hello yym 

I am not sure if it fit to your need but I can suggest a quite different construction.
We are also working with a huge volume of parameters in our API.

First, you should consider to define your query parameters individually, within a dedicated domain:

 

Of course, the schema description is defined within "schemas", in the domain:


When done you can easily use the references in your API file: