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 MVC
, 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?
Answers:
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.
Method 1
Basically, a 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 CSS
, JavaScript
files and other resources needed for a web site, which are not needed for an API.
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 vNext
.
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
Method 2
My two cents…
- In ASP.Net MVC – the MVC’s
Controller
decides what should be theView
– 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
ASPX
pages 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 rendering
Further Reading
- 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
Method 3
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.
Method 4
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.
All methods was sourced from stackoverflow.com or stackexchange.com, is licensed under cc by-sa 2.5, cc by-sa 3.0 and cc by-sa 4.0