swagger-3.0

来源： https://stackoverflow.com/questions/59648179/swagger-3-0-1-server-generator

来源： https://stackoverflow.com/questions/59648179/swagger-3-0-1-server-generator

问题 I have the following api documentation: swagger: "3.0" info: version: 0.0.1 title: Test API paths: /users: get: summary: Get all registered users produces: - application/json responses: 200: description: Users successfully returned 403: description: User not authorised to call this API schema: $ref: 'components.yaml#/components/schemas/AuthError' Where the AuthError schema is defined in a separate yaml file called components.yaml: components: schemas: AuthError: type: object properties: error

问题 I have the following api documentation: swagger: "3.0" info: version: 0.0.1 title: Test API paths: /users: get: summary: Get all registered users produces: - application/json responses: 200: description: Users successfully returned 403: description: User not authorised to call this API schema: $ref: 'components.yaml#/components/schemas/AuthError' Where the AuthError schema is defined in a separate yaml file called components.yaml: components: schemas: AuthError: type: object properties: error

问题 https://www.dariawan.com/tutorials/spring/documenting-spring-boot-rest-api-springdoc-openapi-3/ According to this, using springdoc openapi dependencies should pull in swagger3 I am using <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-ui</artifactId> <version>1.2.15</version> </dependency> <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-webmvc-core</artifactId> <version>1.2.15</version> </dependency> The swaggerui page looks for swagger