API description
Swagger / OpenAPI 2.0
A JSON or YAML format for describing HTTP APIs, commonly called Swagger 2.0.
When to use it
Use this guide when working with existing Swagger 2.0 definitions. Swagger also names a family of API tools; check which specification version your tooling accepts.