我想为我的Swagger API创建一个递归规范 . the Swagger documentation似乎没有这个概念,所以我怀疑它对于Swagger支持的任何替代解决方案都是开放的 .
例如,我正在尝试创建一个类似文档的结构 . 每个文档都有部分,每个部分都有文本和自己的部分 . 我打算像这样使用API endpoints :
-
http://a.b.com/docs/ / section /
-
http://a.b.com/docs/ / section / / section /
-
http://a.b.com/docs/ / section / / section / / section /
如果我使用正则表达式样式,我会在API规范中使用类似的东西:
...
paths:
/docs/{document-id}:
get:
...
/docs/{document-id}(/section/{section-id))+:
get:
...
所以问题是:
-
如何在Swagger / OpenAPI规范中表示任意嵌套资源
-
是否有替代方法可以消除递归规范的需要?
1 回答
我建议使用更简单的API设计 . 在某些公司中,限制最多为2个路径参数 . 更多的东西,你正在推动可用性的限制 .