swagger-2.0

问题 Closed . This question needs to be more focused. It is not currently accepting answers. Want to improve this question? Update the question so it focuses on one problem only by editing this post. Closed 2 years ago . Improve this question I am developing a REST API. during development I have used postman (chrome extension) to use and document my API. It is a wonderful tool and I have most of my API endpoints in it. However, as we near release I would like to document this API in swagger, how

问题 Closed . This question needs to be more focused. It is not currently accepting answers. Want to improve this question? Update the question so it focuses on one problem only by editing this post. Closed 2 years ago . Improve this question I am developing a REST API. during development I have used postman (chrome extension) to use and document my API. It is a wonderful tool and I have most of my API endpoints in it. However, as we near release I would like to document this API in swagger, how

问题 I want to add a documentation to my Node.js API, for this I have a YAML file where I put my definitions, the swagger doc is at localhost:5000/api-doc and working fine. Now I have to add Bearer authorization but Swagger with the following definition: swagger: "2.0" info: version: 1.0.0 title: My API documentation description: > My API documentation host: localhost:5000 basePath: "/v1" schemes: - http securityDefinitions: Bearer: type: apiKey description: "Value: Bearer " name: Authorization in

问题 I want to add a documentation to my Node.js API, for this I have a YAML file where I put my definitions, the swagger doc is at localhost:5000/api-doc and working fine. Now I have to add Bearer authorization but Swagger with the following definition: swagger: "2.0" info: version: 1.0.0 title: My API documentation description: > My API documentation host: localhost:5000 basePath: "/v1" schemes: - http securityDefinitions: Bearer: type: apiKey description: "Value: Bearer " name: Authorization in

问题 Can not get how to use reference of string type with enum values in array parameter. I can make reference in items key and it is working, but Swagger produce error: Not a valid parameter definition Web UI generates interface, but it have textarea instead of multiselect box I expected. What is the proper way to do it? My code: swagger: '2.0': paths: /test: get: parameters: - in: origin name: status description: Origin required: false schema: type: array items: $ref: '#/definitions/Origin'

问题 I have simple REST services implemented with Spring MVC. I decided to describe them with Springfox and Swagger 2.0. Everything seemed to be OK until I started adding security schemas and contexts. I use HTTP Basic authentication for certain endpoints and token-based authentication for others. Whatever I do, I cannot see any option to set HTTP Basic authentication credentials or to specify a token in Swagger UI. Below is my configuration. For simplicity's sake I apply both schemas to all

问题 I have a spring boot rest API project and I am pondering how to change the default error object returned from spring boot. UseCase: /token api is to be called without authentication and other apis are to be called by passing a token. The swagger UI needs to be used for the same purpose. Error response needs to be modified as a custom object. eg: The default structure is like this for Unauthorised api request. { "timestamp": "2020-06-14T05:46:37.538+00:00", "status": 401, "error":

问题 I'm developing spring-boot app with swagger-ui and lombok. Currently I'm trying to hide nested object from request body, but it still shows in example json on swagger-ui page. I have my class with annotations(simplified to only related stuff): @Data @ApiModel(description = "Character model") public class Character { @ApiModelProperty(readOnly = true) private Long id; @ApiModelProperty(readOnly = true) private SearchAnnouncement searchAnnouncement; } Note: @Data is Lombok annotation that

问题 I am getting the following exception when running swagger2. I read online that this is usually due to referencing multiple different versions of the same jar. However, I only found one version of org.ow2.asm:asm:5.0.3 in my gradle jar folder. I also ran gradlew dependencies and found there is only one version of org.ow2.asm:asm: referenced. What else could cause this error? java.lang.IncompatibleClassChangeError: class org.objectweb.asm.tree.ClassNode has interface org.objectweb.asm

问题 I need to document multiple microservices api call,so I have a question that how to create json string out of java pojo class directly. I mean say for example , MyPojo.java public class MyPojo { String name; List<String> address; public MyPojo() { // TODO Auto-generated constructor stub } //setters and getters } now I need the string json structure of the pojo without creating object of the class.May be same the way swagger api creates json structure of @RequestBody object in web UI.