我目前在OpenAPI 3中指定我的API,并且在使用URL时遇到问题,在URL中,请求路径的某些部分将用作参数。
假设我有某种“基本”网址,例如http://example.com/addwords/
。现在,假设此API允许您发布以/
分隔的单词,即/addwords/
之后的所有单词都将被视为任意数量的可选(!)参数。
具体来说,如何在OpenAPI 3中指定可用于以下所有功能的API端点:
http://example.com/addwords/
http://example.com/addwords/a
http://example.com/addwords/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y/z
?
将其拆分为多个/addwords/{word}
无效,因为我将拥有第三方插件,这些插件将实现此类请求的处理程序代码。然后,这些插件将需要将路径本身作为参数传递。