Работа с повторно используемыми компонентами
OAS 3.0 добавляет повторно используемые компоненты в определения API.
Повторно используемые компоненты позволяют использовать элемент в нескольких частях вашего API без необходимости определять его несколько раз.
Если вам нужно повторно использовать один и тот же заголовок в десяти различных операциях, вы можете создать компонент, а затем ссылаться на него во всех операциях, где он необходим. Затем, если вам потребуется отредактировать заголовок, вам не придется делать это во всех десяти операциях. Вы можете просто изменить компонент, и это изменение автоматически распространится на все элементы, которые его используют.
Поддерживаются следующие компоненты:
- Переменные пути
- Параметры запроса
- Заголовки
- Ответы
Компоненты отображаются на вкладке Компоненты на левой панели.