Top "Openapi" questions

The OpenAPI Specification, originally known as the Swagger Specification, is a specification for machine-readable interface files for describing, producing, consuming, and visualizing RESTful Web services.

How to reference array item examples in OpenAPI 3?

Using this schema definition: schemas: AllContacts: type: array items: $ref: '#/definitions/ContactModel1' example: - id: 1 firstName: Sherlock lastName: …

swagger-ui openapi
How to return an array of objects in SwaggerHub?

I am defining an API specification in SwaggerHub using OpenAPI 2.0. The /contacts request returns an array of contacts. The definition …

swagger openapi swagger-2.0
How to generate a PDF or markup from OpenAPI 3.0?

I have an OpenAPI 3.0 spec and I want to generate a PDF out of it so that it can be …

swagger openapi
How do I combine multiple OpenAPI 3 specification files together?

I want to combine an API specification written using the OpenAPI 3 spec, that is currently divided into multiple files that …

api swagger openapi
How do I specify multiple hosts in OpenAPI (Swagger)?

Right now my OpenAPI 2.0 YAML file has only one host URL: host: petstore.test.com basePath: / Can I use multiple …

swagger openapi swagger-2.0
How to define path and formData parameters for the same operation in OpenAPI 2.0?

I have an image upload endpoint that looks like /test/{id}/relationships/image. I want to describe this endpoint using …

swagger swagger-2.0 openapi swagger-editor
OpenAPI: what schema to accept any (complex) JSON value

The API for which I'm writing a Swagger 2.0 specification is basically a store for any JSON value. I want a …

json api swagger-2.0 openapi
Swagger openApi Spec 3.0 - DELETE operation

I am using swagger openapi specification 3.0 to generate swagger from my interface. I have a delete method where it accepts …

swagger openapi swagger-3.0
How to generate OpenAPI 3.0 YAML file from existing Spring REST API?

I have an existing Spring REST API for which I want to generate the OpenAPI 3.0 YAML file and not Swagger 2.0 …

spring spring-boot yaml swagger openapi
OpenAPI (aka Swagger) in Azure Functions V2

I'm creating a V2 Function App and want to use Swagger/Open API for docs, however it is not yet …

azure-devops swagger azure-functions openapi