27 Nov 2017

Swagger documentation customisation

Swagger is a popular software framework that helps developers build RESTful Web services through their entire lifecycle, from design and documentation, to test and deployment. This post focuses on how to incorporate the API documentation generated through Swagger inside an HTML page hosted from another web application.

One of the main features of Swagger is producing interactive documentation for a RESTful API. Swagger can be used in conjunction with a multitude of different languages and frameworks. It will always produce two different outputs inside the same web application hosting the API:

1. A default HTML page having a standard Swagger style. (Europe PMC Annotations API Swagger standard html page)
2. A JSON file that will contain the description of the generated documentation (Europe PMC Annotations API documentation descriptor)