In order to try this out, you can use curl to make the web requests, because this will allow me to specify the headers manually.

Start off by creating a new ASP.NET MVC 4 Web Application in Visual Studio 11:



Then you will be presented with what kind of ASP.NET MVC 4 project that you want to create, select to create a new Web API project:



When the project is created, you’ll have some new things that you haven’t seen before in a normal ASP.NET MVC application. It does look a lot like a normal ASP.NET MVC applications, but with some minor add-ons.

The first thing that we are presented with is the ValuesController and this controller inherits from the ApiController. The ApiController is what you will inherit from when you are creating API specific controllers. It will help you map the HTTP requests GET/POST/PUT/DELETE to the methods with the corresponding names.

The second thing that is added is inside the global.asax.cs, a new route to specify where we retrieve the API specific controllers:

routes.MapHttpRoute(

    name: "DefaultApi",

    routeTemplate: "api/{controller}/{id}",

    defaults: new { id = RouteParameter.Optional }

);

This just help you distinguish between your API calls and non-API calls. If you just start the web application and navigate to /api/values/ you will see a list like this:



If we open this in Internet Explorer 10 instead, it will request a JSON result instead of XML and if we open that up in notepad, it looks like this:



We can verify that this works by testing it out with curl.

Get JSON using curl


Result

["value1","value2"]

Get XML using curl


Result


This is good and all, but we might want to be able to specify what kind of format that we expect with a query string. To do this, we can register a formatter for a certain query string mapping. Go back to global.asax.cs and add the following at the end of Application_Start:


This will allow you to add ?type=json or ?type=xml to request a certain output format:



If you want to retrieve a specific item, you can simply do /api/values/1.

This introduction to ASP.NET Web API was originally posted by Filip Ekberg on blog.filipekberg.se.