Top "Swagger" questions

Swagger is a framework implementation for describing, producing, consuming, and visualizing RESTful web services, based on the OpenAPI specification

How to define mutually exclusive query parameters in Swagger (OpenAPI)?

I have a series of parameters in Swagger like this "parameters": [ { "name": "username", "description": "Fetch username by username/email", "required": …

swagger openapi
Default model example in Swashbuckle (Swagger)

I'm running ASP WebAPI 2 and successfully installed Swashbuckle. I am trying to figure out how one defines what the default …

asp.net-web-api asp.net-web-api2 swagger swagger-ui
how to do friendly base url for swagger 2.8.0

I'm trying to change base access url for API documentation. The url is "http://localhost:8080/swagger-ui.html". I want to …

java spring-boot rest swagger springfox
What is Swagger and does it relate to OData?

I am familiar with the Microsoft stack. I am using OData for some of my restful services. Recently I came …

odata swagger swashbuckle openapi
How to annotate a field as deprecated in OpenAPI (Swagger) 2.0?

I have the following schema definition: swagger: '2.0' ... definitions: Service: type: object properties: serviceId: type: string description: Device or …

swagger swagger-2.0 openapi
How to fully disable swagger-ui in spring-boot?(/swagger-ui.html should return 404)

I have read following topic: Disabling Swagger with Spring MVC and I wrote: @Bean public Docket api() { return new Docket(…

java spring spring-boot swagger swagger-ui
Spring @GetMapping with @RequestParam and @RequestBody fails with HttpMessageNotReadableException

Request to the endpoint fails with the following error: 400 Bad request org.springframework.http.converter.HttpMessageNotReadableException: Required request body is …

spring http swagger spring-restcontroller
Use object type query param in swagger documentation

I have a GET route where I would like to encode an object parameter in the url as a query …

swagger swagger-ui query-parameters
Swagger-PHP for generating JSON file for Swagger-UI

I am trying to use Swagger-PHP for generating JSON files , so that I can use it with Swagger-UI for auto …

php json swagger autodoc
Define array of multiple models in Swagger 2.0

This is my first foray into Swagger so please be gentle. I have the following definitions: definitions: Payload: type: object …

swagger swagger-2.0