Зачем нужен блок components в OpenAPI (Swagger)?

Блок components используется для переиспользования кода (DRY — Don't Repeat Yourself).

Вместо того чтобы в каждом эндпоинте (GET /users, POST /users, PUT /users) заново описывать структуру объекта "Пользователь", аналитик описывает ее один раз в components/schemas/User.

Затем в самих эндпоинтах просто ставится ссылка:
$ref: '#/components/schemas/User'

✅ Итог: YAML-файл становится компактным. Если в объект "Пользователь" добавится новое поле, его нужно будет изменить только в одном месте.