Asp.Net Web API

Introduction

ASP.NET Web API is a framework that makes it easy to build HTTP services that reach a broad range of clients, including browsers and mobile devices. ASP.NET Web API is an ideal platform for building RESTful applications on the .NET Framework.

It is very similar to ASP.NET MVC since it contains the MVC features such as routing, controllers, action results, filter, model binders, IOC container or dependency injection. But it is not a part of the MVC Framework. It is a part of the core ASP.NET platform and can be used with MVC and other types of Web applications like Asp.Net WebForms. It can also be used as a stand-alone Web services application.

Why Asp.Net Web API (Web API) ?

 If you like to expose your service data to the browsers and as well as all modern devices apps in fast and simple way, you should have an API which is compatible with browsers and all devices.

Web API is the great framework for exposing your data and service to different-different devices. Moreover Web API is open source an ideal platform for building REST-ful services over the .NET Framework. Unlike WCF Rest service, it use the full features of HTTP (like URIs, request/response headers, caching, versioning, various content formats) and you don't need to define any extra config settings for different devices unlike WCF Rest service.

Web API Features

1.  It supports convention-based CRUD Actions since it works with HTTP verbs GET,POST,PUT and DELETE.
   
2. Responses have an Accept header and HTTP status code.
   
3. Responses are formatted by Web API’s MediaTypeFormatter into JSON, XML or whatever format you want to add as a MediaTypeFormatter.
   
4. It may accepts and generates the content which may not be object oriented like images, PDF files etc.
   
5. It has automatic support for OData. Hence by placing the new [Queryable] attribute on a controller method that returns IQueryable, clients can use the method for OData query composition.
   
6. It can be hosted with in the applicaion or on IIS.
   
7. It also supports the MVC features such as routing, controllers, action results, filter, model binders, IOC container or dependency injection that makes it more simple and robust.
   

Why to choose Web API ?

1. If we need a Web Service and don’t need SOAP, then ASP.Net Web API is best choice.
   
2. It is Used to build simple, non-SOAP-based HTTP Services on top of existing WCF message pipeline.
   
3. It doesn't have tedious and extensive configuration like WCF REST service.
   
4. Simple service creation with Web API. With WCF REST Services, service creation is difficult.
   
5. It is only based on HTTP and easy to define, expose and consume in a REST-ful way.
   
6. It is light weight architecture and good for devices which have limited bandwidth like smart phones.
   
7. It is open source.
   

Asp.Net Web API VS Asp.Net MVC

1. Asp.Net MVC is used to create web applications that returns both views and data but Asp.Net Web API is used to create full blown HTTP services with easy and simple way that returns only data not view.
   
2. Web API helps to build REST-ful services over the .NET Framework and it also support content-negotiation(it's about deciding the best response format data that could be acceptable by the client. it could be JSON,XML,ATOM or other formatted data), self hosting which are not in MVC.
   
3. Web API also takes care of returning data in particular format like JSON,XML or any other based upon the Accept header in the request and you don't worry about that. MVC only return data in JSON format using JsonResult.
   
4. In Web API the request are mapped to the actions based on HTTP verbs but in MVC it is mapped to actions name.
   
5. Asp.Net Web API is new framework and part of the core ASP.NET framework. The model binding, filters, routing and others MVC features exist in Web API are different from MVC and exists in the new System.Web.Http assembly. In MVC, these featues exist with in System.Web.Mvc. Hence Web API can also be used with Asp.Net and as a stand alone service layer.
   
6. You can mix Web API and MVC controller in a single project to handle advanced AJAX requests which may return data in JSON, XML or any others format and building a full blown HTTP service. Typically, this will be called Web API self hosting.
   
7. When you have mixed MVC and Web API controller and you want to implement the authorization then you have to create two filters one for MVC and another for Web API since boths are different.
   
8. Moreover, Web API is light weight architecture and except the web application it can also be used with smart phone apps.