Skip to Content
Hands-On RESTful Web Services with ASP.NET Core 3
book

Hands-On RESTful Web Services with ASP.NET Core 3

by Samuele Resca
December 2019
Intermediate to advanced
510 pages
11h 33m
English
Packt Publishing
Content preview from Hands-On RESTful Web Services with ASP.NET Core 3

Implementing the Swagger project

Just like the OpenAPI Specification, Swagger was born as a language-agnostic specification for describing REST APIs. It has recently been adopted by the OpenAPI project, which means there are no differences between these two projects.

The main aim of Swagger is to autogenerate and expose a document called swagger.json, also known as the Swagger Specification. The Swagger Specification is the autogenerated documentation of the API and provides information about every single route that's exposed by the web services. The following code shows the structure of an example swagger.json file:

{  "x-generator": "NSwag v12.0.12.0 (NJsonSchema v9.13.15.0 (Newtonsoft.Json v12.0.0.0))",  "swagger": "2.0",  "host": "localhost:5000" ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

AirBnbBlueOriginElectronic ArtsHomeDepotNasdaqRakutenTata Consultancy Services

QuotationMarkO’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.
Julian F.
Head of Cybersecurity
QuotationMarkI wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.
Addison B.
Field Engineer
QuotationMarkI’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.
Amir M.
Data Platform Tech Lead
QuotationMarkI'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
Mark W.
Embedded Software Engineer

You might also like

Pro ASP.NET Web API: HTTP Web Services in ASP.NET

Pro ASP.NET Web API: HTTP Web Services in ASP.NET

Tugberk Ugurlu, Alexander Zeitler, Ali Kheyrollahi
ASP.NET Core and Vue.js

ASP.NET Core and Vue.js

Devlin Basilan Duldulao
ASP.NET Core MVC 2.0 Cookbook

ASP.NET Core MVC 2.0 Cookbook

Jason De Oliveira, Engin Polat, Stephane Belkheraz

Publisher Resources

ISBN: 9781789537611