Overview of the Swagger JSON File

The swagger.json file is a specification file that describes the REST APIs in accordance with the Swagger specification. The file describes details such as available endpoints, operations on each endpoint, input and output parameters for each operation, authentication methods, and other information.

Basic Structure of File

For more information on the basic structure of the swagger.json file, refer to http://docs.swagger.io/spec.html#52-api-declaration.

The Swagger representation can be specified in a single file or split into separate files, at your discretion. If it is split across files, you can use $ref fields in the specification to reference parts in different files. For more information on the $ref field, refer to https://swagger.io/docs/specification/using-ref.