如何将Swagger2.0 JSON文件分解成多个模块
我正在尝试将我的API文档分解成多个JSON文件，这些文件可以独立编辑。我能找到的所有示例都使用了Swagger1.2模式，它有一个“api”：{}对象来分解它。2.0模式(http://json.schemastore.org/swagger-2.0)中似乎缺少这一点。定义的只是一个“路径”数组，它将所有APIendpoint绑定到这个数组中。这在swagger-ui中的效果是，有一个单一的“默认”类别，所有的东西都被捆绑到其中，我无法告诉如何将其拆分。
TLDR：在Swagger2.0模式中，如何将操作与路径分离
js prettyprint-override">{
"swagger": "2.0",
"info": {
"description": "My API",
"version": "1.0.0",
"title": "My API",
"termsOfService": "http://www.domain.com",
"contact": {
"name": "support@domain.com"
}
},
"basePath": "/",
"schemes": [
"http"
],
"paths": {
"Authorization/LoginAPI": {
"post": {
"summary": "Authenticates you to the system and produces a session token that will be used for future calls",
"description": "",
"operationId": "LoginAPI",
"consumes": [
"application/x-www-form-urlencoded"
],
"produces": [
"application/json"
],
"parameters": [{
"in": "formData",
"name": "UserName",
"description": "Login Username",
"required": true,
"type": "string"
}, {
"in": "formData",
"name": "Password",
"description": "Password",
"required": true,
"type": "string"
}],
"responses": {
"200": {
"description": "API Response with session ID if login is allowed",
"schema": {
"$ref": "#/definitions/Authorization"
}
}
}
}
}
}
}
共有1个答案
你实际上在一个里面问了几个问题，我试着全部回答。
在Swagger1.2及其之前的版本中，文件拆分是强制性的和人为的。这是一种分组操作的方法，Swagger2.0提供了一种替代方法（很快会有更多的介绍）。
Swagger 2.0实际上是一个单独的文件，它允许在使用$ref的地方使用外部文件。不能将单个服务拆分为多个文件并将它们合并为一个文件，但可以在外部为特定路径指定操作（同样，使用$ref属性）。
-
本文向大家介绍Python如何将将模块分割成多个文件，包括了Python如何将将模块分割成多个文件的使用技巧和注意事项，需要的朋友参考一下 问题 你想将一个模块分割成多个文件。但是你不想将分离的文件统一成一个逻辑模块时使已有的代码遭到破坏。 解决方案 程序模块可以通过变成包来分割成多个独立的文件。考虑下下面简单的模块： 假设你想mymodule.py分为两个文件，每个定义的一个类。要做到这一点，首
-
问题 你想将一个模块分割成多个文件。但是你不想将分离的文件统一成一个逻辑模块时使已有的代码遭到破坏。 解决方案 程序模块可以通过变成包来分割成多个独立的文件。考虑下下面简单的模块： # mymodule.py class A: def spam(self): print('A.spam') class B(A): def bar(self): pr
-
问题内容： 我有以下代码： 我将有许多服务（如一项服务），并且我不想将它们全部放在同一个文件中。 我在Stack Overflow中读了另一个问题，我可能需要这样的其他文件：在该文件中写入所有服务，但是当我启动Node时会抛出该错误。 如何分隔代码？ 问题答案： 您可以在不同的文件（例如 test-routes.js）中 定义路由，如下所示： 现在在您的主文件中说出 server.js， 您可以像
-
问题内容： 我有一个几分钟的.wav文件，我想分割成10秒的另一个.wav文件。 到目前为止，这是我的python代码： 印刷产量： 我知道这是框架列表。我如何为该列表中的每个元素制作一个wav文件（第一个.wav文件将是？Python的模块尚不清楚如何使用框架创建.wav文件。 编辑：这是一个重复的问题，如何在python中将音频文件（wav格式）拼接为1秒拼接？ 但是，如果某人的答案不需要，我
-
问题内容： 我得到一个包含以下内容的文本文件（12 MB）： 有什么办法来分流到12个* .txt文件让说，，（......）？ 问题答案： 您可以使用linux bash核心实用程序 注意，或两者都OK，但大小不同。MB为1000 * 1000，M为1024 ^ 2 如果要按行分隔，可以使用参数。 更新 Kirill建议的另一种解决方案，您可以执行以下操作 请注意，是不是，有几个选项，比如，，，
-
我正在使用Ubuntu，希望将一个包含图像的文件夹（30k图像）拆分为不同的文件夹。但是，我想对它们进行排序（而不仅仅是拆分成更小的子文件夹）。我有一个文件，其中包含图像的文件夹目标信息。该文件的结构如下： 123.jpg，1 124.jpg，2 125.jpg，3 这应该解释为：image 123.jpg到文件夹1，image 124.jpg到文件夹2，image 125.jpg到文件夹3。 在