将swagger文档拆分为单独的集合

时间:2018-09-07 08:14:44

标签: .net-core swagger swagger-ui

我正在使用带有.net核心的swagger,我想知道是否可以拆分2组或更多组通过不同URL访问的swagger文档。 这里不是在谈论版本。

例如,如果我有适用于移动应用程序,Web应用程序的API,以及适用于我的客户的API。 我想分别将它们分开,并且还只为移动和Web API添加授权,而不是为客户端添加授权。 我有将各个api划分为多个区域的想法,但我仍然不知道如何将这些api拆分为广泛的文档。

我唯一能获得相同结果的方法是将其拆分为单独的项目。

任何其他解决此问题的想法都受到欢迎。 谢谢。

1 个答案:

答案 0 :(得分:0)

一种可能性(并非最佳)是手工编写规范,因为它只是一个JSON文件。

第二个示例使用此示例:https://github.com/domaindrivendev/Swashbuckle.AspNetCore#generate-multiple-swagger-documents

“版本”一词不仅意味着同一API的不同版本,还意味着“客户端api”,“ webapi”等。