Book Image

Robust Cloud Integration with Azure

By : Gyanendra Kumar Gautam, Ashish Bhambhani, Abhishek Kumar, James Corbould, Mahindra Morar, Martin Abbott
Book Image

Robust Cloud Integration with Azure

By: Gyanendra Kumar Gautam, Ashish Bhambhani, Abhishek Kumar, James Corbould, Mahindra Morar, Martin Abbott

Overview of this book

Any software developers, architects, and technical managers lookng to learn about Azure IaaS essentials need look no further. This book is ideal for Microsoft Enterprise developers, DevOps or any IT professionals looking to connect cloud-based and on-premises systems with Azure.
Table of Contents (23 chapters)
Robust Cloud Integration with Azure
Credits
Foreword
About the Authors
About the Reviewers
www.PacktPub.com
Customer Feedback
Preface

Building, hosting, and consuming your first API App


Let's start with the app.

What is Swagger?

Swagger is open source software that provides powerful metadata representation of your RESTful API. It is a specification for documenting RESTful APIs. It is machine-readable and language agnostic, so there are different implementations for different platforms.

In Azure API Apps, Microsoft adapts Swashbuckle to implement Swagger 2.0. So, the API you create can be easily discoverable using metadata in Swagger 2.0 format, which is widely accepted and supported.

Support for Swagger 2.0 (Refer: http://swagger.io/) API metadata is built into Azure App Service. Each API App can specify a URL endpoint that returns metadata for the API in Swagger JSON format. The JSON metadata returned from that endpoint can be used to generate client code.

If you have a Web API project, then to add Swagger to the project you need to install Swashbuckle via NuGet. Swashbuckle enables the way Swagger metadata is generated for...