Swagger 2.0

Swagger 2.0 is the first release of the Swagger specification that is used to describe RESTful APIs. There are some gaps in the specification but the tool chain around this specification is the most mature. As OpenAPI 3.0 is new, most existing project are using Swagger 2.0 specification format. For brand new project, it is recommended using OpenAPI 3.0.

There are some middleware handlers designed for Swagger 2.0 specification.

Swagger 2.0 Specific Handlers

  • swagger-meta loads the swagger.json from the config folder during server start and caches the specification per endpoint.
  • swagger-security verifies the JWT token signature and expiration as well as scopes if they are defined in the specification.
  • swagger-validator validates the request headers, path parameters, query parameters and body against the specification.
“Swagger 2.0” was last updated: April 2, 2019: fixes #62 add Chinese language for the document site (5c820aa)
Improve this page