Oleksandr Savchenko
и вам за вопрос - в данные ексельки например кросс-контракты вы можете добавить также копомненты которые будут решать вашу проблему,например какой компонент вы будете использовать для фильтрации или пагинации, да и вообще лучше то как будуте отдавать в АПИ данные лучше описать и договориться с Фронтом, а потом вам будет это проще описывать в СВАГЕРе, или например указать как вы будте делать авторизацию и аутентификацию - закинуть в табличку протоколы и линки на Сиквенс Диаграммы которые будут описаны на другой страничке.
на своем опыте встречал только описания эндпоинтов в свагере, кажется что для бизнеса такое подробное описание может сделать разработку и принятые решения в проекте более прозрачними нежели всем известное "исторически так сложилось"