I am new to ASP.NET MVC and Web API and trying to get the basics. AFAIK, we have project templates in VS 2013, named as
Web API and
Both of them together.
I have gone through the tutorials and learned that we can make an API by using MVC alone as well as with Web API Template.
So, What are the differences between these, based on Architecture and Usage?
Thank you for visiting the Q&A section on Magenaut. Please note that all the answers may not help you solve the issue immediately. So please treat them as advisements. If you found the post helpful (or not), leave a comment & I’ll get back to you as soon as possible.
Web API controller is an
MVC controller, which uses
HttpMessageResponse as the base type of its response, instead of
ActionResponse. They are the same in most other respects. The main difference between the project types is that the
MVC Application project type adds web specific things like default
MVC is used for creating web sites. In this case
Controllers usually return a
View (i.e. HTML response) to browser requests. Web APIs on the other hand are usually made to be consumed by other applications. If you want to allow other applications to access your data / functionality, you can create a Web API to facilitate this access. For example, Facebook has an API in order to allow App developers to access information about users using the App. Web APIs don’t have to be for public consumption. You can also create an API to support your own applications. For example, we created a Web API to support the AJAX functionality of our MVC web site.
Microsoft changed the way they present the different templates. Now instead of using different templates for different project types, they encourage developers to mix ASP.NET technologies inside the same project as needed. Microsoft calls this
UPDATE: For ASP.NET Core, Web API has been integrated into the MVC 6 project type and the
ApiController class is consolidated into the
Controller class. Further details at: https://wildermuth.com/2016/05/10/Writing-API-Controllers-in-ASP-NET-MVC-6
My two cents…
- In ASP.Net MVC – the MVC’s
Controllerdecides what should be the
View– i.e., the controller decides what the user should “see” (based on the current scenario or context), when they make a request.
- In ASP.Net Web Forms, the
ASPXpages decides what the user should “see” when they make a request.
- But in Web API, there is no control/power to any of the Web API’s features to decide what the user should “see” when they make a request.
Web API is NOT a technology tied up with websites only. It can be used for multiple purposes – not only websites. So it doesn’t know the meaning of
- Planning Web Solutions Today: Web Forms, ASP.NET MVC, Web API, and OWIN.
- WCF or ASP.NET Web APIs? My two cents on the subject
- The Next Generation of .NET – ASP.NET vNext
- Getting Started with ASP.NET MVC 6
MVC controller derived from controller class. In Mvc you can returns views. Mvc achitecture uses to create an application. However Web apis are used to provide data to various application.
Web Api drives from Api controller and it doesn’t return view.
Note: You can also create Web Api from MVC controller but you need to return result as JsonResult or other web api supported return types.
In addition to answers already provided here, its worth noting any controller which inherits from ApiController and having an action with Http verb POST can only have one [FromBody] input parameter. If using a MVC controller (deriving from ‘Controller’) you can have many post input parameters.