Create REST Web API And Add Multiple POST Methods In One Controller

In this article, we will see the basics of how to create a REST Web API project in ASP.NET using Visual Studio 2017 Community Edition. We will also see how to add multiple POST methods in one Controller.

Recently, I had to create a REST web API project. We had a requirement of communicating from Office 365 apps to the on-premise database. So, we thought of creating APIs hosted on a local server, exposed out of a firewall, and performing the required operations on the database. Let’s see the basics of it.
 

Create REST Web API project

 
If you don’t have Visual Studio installed, you can easily download the latest Community Edition (free) and install it on your machine.
 
Open Visual Studio >> Add New Project >> select “ASP.NET Web Application (.NET Framework)” project template >> Give a meaningful name to the project and click OK.
 
Create REST Web API And Add Multiple POST Methods In One Controller
 
On the next screen, select “Web API” template and click OK.
 
Create REST Web API And Add Multiple POST Methods In One Controller
 
A Web API project with default controller and default methods gets created, as shown below.
 
Create REST Web API And Add Multiple POST Methods In One Controller
 
Run the project to test it (click F5) >> by default, Internet Explorer browser will open. Copy the root URL and hit the below API in Chrome or Firefox browser to see the XML/JSON response API endpoint - /api/values.
 
Create REST Web API And Add Multiple POST Methods In One Controller
 
You can publish the project to Azure web API or local drive. If you want to host this API to on-premise server IIS, then copy the published folder content and paste it in the virtual directory of your IIS site.
 

Add multiple POST methods

 
Now let’s see how we can add multiple posts or for that matter, any methods in one controller.
 
Open your controller class, in our project its ValuesController.cs >> Copy paste below code, these are two sample post methods with a string input and return parameter – you can write your business logic in it. Similarly, you can add any number of POST, GET, PUT, DELETE methods in one controller.
 
Create REST Web API And Add Multiple POST Methods In One Controller
  1. [HttpPost]  
  2. public string AddCase([FromBody]string value)  
  3. {  
  4.     return value + " - New Case Added successfully!";  
  5. }  
  6.   
  7. [HttpPost]  
  8. public string UpdateCase([FromBody]string value)  
  9. {  
  10.     return value + " - Case updated successfully!";  
  11. }  

Important configuration

 
Now, we need to update the route template in WebApiConfig.cs >> Open this class from App_Start folder >> update default MapHttpRoute to new template as shown below >> we just need to add {action} after {controller}
 
Create REST Web API And Add Multiple POST Methods In One Controller
  1. config.Routes.MapHttpRoute(  
  2.     name: "DefaultApi",  
  3.     routeTemplate: "api/{controller}/{action}/{id}",  
  4.     defaults: new { id = RouteParameter.Optional }  
  5. );  
And we are done. Let’s test it with SoapUI. You can easily test get methods in browser but to test post methods you need a tool like SoapUI.
 
Run Web API project from Visual Studio >> Open SoapUI >> Add new REST Project >> Enter localhost API URL with resource names like http://localhost:54279/api/values/AddCase
 
As you can see we are able to call AddCase post method successfully - we are passing the string as a body to request and getting a string as a response on right side of the screen.
 
Create REST Web API And Add Multiple POST Methods In One Controller
 
And we are able to run the second post method - UpdateCase with success result as well. You can save this SoapUI project for future testing purposes.
 
Create REST Web API And Add Multiple POST Methods In One Controller
 
You can send JSON data as the body to your API method, you can make your API authenticated from IIS. We will see more of this in other blogs/articles. That’s it for this article. I hope this helps.