Visualizing and Testing REST Service Bindings Using Swagger

Swagger is a set of open-source tools that can help you design, build, document, and consume REST APIs. Swagger scans the application code and exposes the documentation on the URL. You can consume this URL (a JSON document) to understand the capabilities of the REST service without accessing the actual source code and documentation.

For more information on Swagger, refer to https://swagger.io/.

Swagger is built around OpenAPI Specification. Currently, It uses Swagger specification version 2.0 and Application API version 1.0. The specification defines a set of files required to describe the API. The files can be written in YAML or JSON format. These files can then be used by the Swagger UI to display the API. For more information on the OpenAPI Specification, refer to https://swagger.io/specification/.

Using Swagger UI integrated with TIBCO ActiveMatrix Service Grid, you can:

  • View all REST Service Endpoints and Operations on each Endpoint implemented by the REST Service
  • Examine the inputs and outputs for each operation in JSON format with detailed schema
  • Allow end developers to effortlessly interact and try out every single operation that the API exposes for easy consumption
  • Specify JSON or XML as the content type for a Request and Response for each Operation
  • Invoke an Operation and receive a live Response for the input specified
  • Generate and download a Swagger.json file