Creating A Web API Using Visual Studio 2017

using System.Collections.Generic;  
using System.Web.Http;  
using WebAPIDemo.Models;  
  
namespace WebAPIDemo.Controllers  
{  
    public class HomeController : ApiController  
    {  
          
  
        public IEnumerable<Product> GetItems()  
        {  
            IList<Product> products = new List<Product>  
            {  
                new Product  
                {  
                    productName = "Biscuits",  
                    manufacturingYear = 2018,  
                    brandName="ParleG"  
                },  
                new Product  
                {  
                    productName = "Cars",  
                    manufacturingYear = 2018,  
                    brandName="BMW"  
                },  
                new Product  
                {  
                    productName = "Cars",  
                    manufacturingYear = 2018,  
                    brandName="Mercedese"  
                },  
                new Product  
                {  
                    productName = "Brush",  
                    manufacturingYear = 2017,  
                    brandName="Colgate"  
                }  
  
            };  
  
            return products;  
        }  
    }    
}

We have written an API method which, when called, will return the list of products. Here, we can also write the logic to fetch these values from the database. For keeping it simple, I have used hardcoded values. I have returned a list of Product entity here. We will see later how to run this.

Before doing this, write a Product.cs class in Models which you can use in the Controller. For me, it was like following.

namespace WebAPIDemo.Models  
{  
    public class Product  
    {  
        public string productName { get; set; }  
        public int manufacturingYear { get; set; }  
        public string brandName { get; set; }  
    }
} 

I am telling you about the main files that you need to check before running this Web API. My WebApiConfig.cs file looks like this. This file is important because it will tell how we would be able to call our methods over the web. Technically, it configures the routes (paths to call Web APIs).

public static class WebApiConfig  
{  
    public static void Register(HttpConfiguration config)  
    {  
        // Web API configuration and services  

        // Web API routes  
        config.MapHttpAttributeRoutes();  

        config.Routes.MapHttpRoute(  
            name: "DefaultApi",  
            routeTemplate: "api/{controller}/{action}/{id}",  
            defaults: new { id = RouteParameter.Optional }  
        );  

    }  
}

After this is done, we are ready to run our Web API project. Just build the project and debug. For debugging, you can press Ctrl+F5. It will open a browser window as below.

This is coming like this because we have not done anything for this route. To see the actual result, we need to change our URL according to the path given in WebApiConfig.cs. So, if you would do that, you will see the successful result in form of XML as below.

You can see that we have created our Web API easily using VS 2017. Here, we have used the browser to hit this Web API in debugging mode but we can easily consume this Web API into other applications and see the result in the format we want.

Conclusion

Using the simple steps, we have learned here how to create a Web API project using Visual Studio 2017. We have covered end to end flow so that you do not face any difficulty. If you have any queries on this, do write in the comments section and also if it helps you somewhere, you can leave your feedback.