Как вы справляетесь с наличием дублирующих или длинных параметров пути в сваггере или YAML? - PullRequest
0 голосов
/ 02 сентября 2018

Есть ли способ сократить параметр пути, который у меня есть, или какой-либо способ ссылки на тот же путь только с большим количеством параметров? Я работаю над документацией API в Swagger.

Вот пример: Параметр пути с несколькими параметрами:

   /test/{StudentID}/{StudentName}/grade/{letterGrade}/passFail

ошибка, которую генерирует swagger: Объявленный параметр пути "StudentName" должен быть определен как параметр пути в любом из уровень пути или операции

Вот пример пути с такими же параметрами в первой половине пути:

/test/{StudentID}/{StudentName}/grade/{letterGrade}/passFail/gradelevel

/test/{StudentID}/{StudentName}/grade/passFail

/test/{StudentID}/{StudentName}/grade

Теперь все они также являются запросами на получение, так как я могу легко документировать это в YAML? или чванство?

...