-
Notifications
You must be signed in to change notification settings - Fork 9.1k
Open
Labels
param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serializationre-use: globals/defaultsDefault or global components that can be overridden in some wayDefault or global components that can be overridden in some wayre-use: traits/mergesSelective or modified re-useSelective or modified re-use
Milestone
Description
Hi!
For example, there are several paths that include similar parameters, but with different required options: in some paths parameters are required, in others they are optional.
If we can specify the required option separately, we can reuse parameter descriptions. Like this:
/api/v1/rootname:
get:
summary: 'Path example'
parameters:
- $ref: '#/components/parameters/queryFiltersDateFrom'
- $ref: '#/components/parameters/queryFiltersDateTo'
- $ref: '#/components/parameters/queryGroups'
- $ref: '#/components/parameters/queryOrderByColumn'
- $ref: '#/components/parameters/queryOrderByDirection'
required:
- 'filters[date_from]'
- 'filters[date_to]'
- 'groups'
- 'order_by_column'
- 'order_by_direction'
Morgunov-Vitaly and Kostadin-Ivanov
Metadata
Metadata
Assignees
Labels
param serializationIssues related to parameter and/or header serializationIssues related to parameter and/or header serializationre-use: globals/defaultsDefault or global components that can be overridden in some wayDefault or global components that can be overridden in some wayre-use: traits/mergesSelective or modified re-useSelective or modified re-use