前端express 框架swagger 遇到了接口只能一种情况,是不是,swagger的接口要放入不同文件啊,比如不同 请求路径的api 接口如何写 怎么使用,我不会写其他的路径请求接口,这是json 文件格式,我的项目没有问题的,也使用了,只是在编写swagger的时候,发现不能编写多个接口,会有覆盖的情况,好像path:{} 只能有一个
在使用Swagger时,您可以使用多个JSON文件来定义不同的API接口。您可以按照以下步骤将Swagger分成多个文件:
-
在您的项目中创建一个名为“swagger”的文件夹。
-
在该文件夹中,创建一个名为“swagger.json”的文件,用于定义您的API文档的基本信息。
-
在该文件夹中,创建一个名为“api”的文件夹,用于存储您的API接口定义文件。
-
在“api”文件夹中,为每个不同的请求路径创建一个JSON文件,例如“users.json”或“orders.json”。
-
在每个JSON文件中,定义该请求路径下的所有API接口。
-
在“swagger.json”文件中,使用“$ref”关键字引用每个API接口定义文件。
例如,您可以在“swagger.json”中使用以下代码段引用“users.json”文件中的API接口:
{
"swagger": "2.0",
"info": {
"title": "My API",
"version": "1.0.0"
},
"paths": {
"/users": {
"$ref": "api/users.json"
}
}
}
这样,您就可以将Swagger分成多个文件,以便更好地组织和管理您的API接口定义。
原文地址: https://www.cveoy.top/t/topic/szp 著作权归作者所有。请勿转载和采集!