前端express 框架swagger 遇到了接口只能一种情况,是不是,swagger的接口要放入不同文件啊,比如不同 请求路径的api 接口如何写 怎么使用,我不会写其他的路径请求接口
Swagger可以将不同请求路径的API接口写在同一个文件中,也可以将其分别写在不同的文件中。如果你想将不同请求路径的API接口写在同一个文件中,可以使用Swagger的路径参数来区分不同的请求路径。例如,你可以在Swagger中定义一个GET请求的路径参数,如下所示:
"/users/{userId}"
这个路径参数可以匹配所有以/users/开头的请求路径,其中的{userId}表示这个参数可以在请求路径中动态地替换成实际的用户ID。然后,你可以在同一个Swagger文件中定义多个这样的路径参数,来实现不同请求路径的API接口。
如果你想将不同请求路径的API接口写在不同的文件中,可以使用Swagger的文件引用功能。首先,你需要将不同请求路径的API接口分别写在不同的Swagger文件中,并在这些文件中定义好它们的请求路径和参数。然后,在主Swagger文件中,你可以使用$ref关键字来引用这些文件中的API接口定义,如下所示:
paths:
/users:
$ref: ./users.yaml#/paths/users
/products:
$ref: ./products.yaml#/paths/products
这样,Swagger就可以将这些不同请求路径的API接口自动合并成一个完整的API文档。
原文地址: https://www.cveoy.top/t/topic/sy9 著作权归作者所有。请勿转载和采集!