Tag: 招 用户

如何将swagger 2.0的JSON文件分解成多个模块

我试图把我的API文档分解成多个可以独立编辑的JSON文件。 我所能find的所有示例都使用Swagger 1.2模式,它具有“api”:{}对象来分解它。 这似乎是从2.0架构( http://json.schemastore.org/swagger-2.0 )丢失。 所有定义的是一个单一的“path”数组,它将所有API端点绑定到单个数组中。 这在swagger-ui中的效果是有一个单一的“默认”类别,所有东西都捆绑在一起,我不能分辨出来。 TLDR:你如何将操作从swagger 2.0模式中的path中分离出来 { "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 […]