Top "Swagger-editor" questions

Swagger Editor allows users to create API specifications using YAML inside the browser and to preview documentation in real time.

How can I represent 'Authorization: Bearer <token>' in a Swagger Spec (swagger.json)

I am trying to convey that the authentication/security scheme requires setting a header as follows: Authorization: Bearer <token&…

swagger swagger-2.0 swagger-editor
Swagger Editor multiple parameters in body

So I understand that if we want body parameters we have to have a schema, which I do. The issue …

swagger swagger-editor
How to format Swagger 2.0 text descriptions?

I would like to format my Swagger API descriptions so that they are not simple paragraphs of text. Preferably, I'd …

rest markdown swagger swagger-2.0 swagger-editor
Validating JSON against Swagger API schema

I created an API spec from some JSON files and I am trying to test if the files validate against …

json swagger swagger-ui jsonschema swagger-editor
Swagger Editor shows the "Schema error: should NOT have additional properties" error for a path parameter

I'm using http://editor.swagger.io to design an API and I get an error which I don't know how …

swagger swagger-2.0 swagger-editor
Multi-line literals in swagger editor?

I am trying to get a multi-line literal in Swagger editor (awesome tool, by the way!). post: summary: Translate one …

yaml swagger indentation swagger-editor
Define a response object with an array in YAML using Swagger Editor

I'm working on an API definition in Swagger Editor with YAML. I am trying to represent the following response body: { …

swagger swagger-editor
Swagger complex response model with dynamic key value hash maps

I'm struggling with the syntax of swagger to describe a response type. What I'm trying to model is a hash …

hashmap swagger swagger-2.0 swagger-editor
Swagger Editor shows "Failed to fetch" error

I'm new to Swagger and using Swagger Editor running locally on my desktop to test an API. I'm not responsible …

swagger-editor
"discriminator" in polymorphism, OpenAPI 2.0 (Swagger 2.0)

Referencing OpenAPI 2.0, Schema Object, or Swagger 2.0, Schema Object, and the definition of discriminator field as: Adds support for polymorphism. The …

swagger swagger-2.0 swagger-editor openapi swagger-tools