您如何处理在swagger或YAML中具有重复或长路径参数?

时间:2018-09-01 21:47:07

标签: api swagger documentation

是否有一种方法可以缩短我拥有的路径参数,或者以某种方式使用更多参数引用同一路径?我正在忙着处理API文档。

这里是一个示例:     具有多个参数的路径参数:

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

挥动产生的错误是声明的路径参数   需要在任一位置将“ StudentName”定义为路径参数   路径或操作级别

这是路径的上半部分具有相同参数的路径示例:

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

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

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

现在所有这些都是get请求,那么如何在YAML中轻松地对此进行记录?还是大摇大摆?

0 个答案:

没有答案