Swagger tutorial -- How to add Swagger OpenAPI to your REST API documentation

By: (plus.google.com) +David Herron; Date: Jan 9, 2017

Tags: OpenAPI

An introduction to Swagger/OpenAPI. A core idea given is documentation that's interactive, and unlike typical documentation as it appears in a slide deck. The power of having an API described in an industry-standard format is the wide variety of tools available.

The Swagger Editor ( (swagger.io) http://swagger.io/swagger-editor/) interactively verifies the OpenAPI spec file.

Generating the Swagger Spec for your API, done either "manually" (editing it yourself), or automatically by annotations in your source code.

Swagger UI ( (swagger.io) http://swagger.io/swagger-ui/) parses the API spec, letting you browse it in a web browser