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 about the basic structure of the
swagger.json file, see
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 about the
$ref field, see
https://swagger.io/docs/specification/using-ref.