In the past I’ve looked at ServiceStack for developing REST services however there are alternatives to ServiceStack, one of which is Web Api. Let’s create a simple starter project using ASP.NET Core and Web Api to implement our services.<\/p>\n
The generated service supplies a Controllers\/ValuesController.cs file which includes a controller class with the various REST methods.<\/p>\n
Controllers partition your application’s API, so for example you might have an AuthenticateController solely for authentication methods and another controller for CRUD operations on a datasource. <\/p>\n
For example this is a simple AuthenticateController class <\/p>\n
\r\n[Route("[controller]")]\r\n[ApiController]\r\npublic class AuthenticateController : ControllerBase\r\n{\r\n [HttpPost]\r\n public ActionResult<AuthenticateReponse> Post([FromBody] User user)\r\n {\r\n return new AuthenticateReponse\r\n {\r\n Token = $"{user.Name}|1234"\r\n };\r\n }\r\n}\r\n<\/pre>\nHere, the Route is set to [controller] so our URL would be http:\/\/localhost\/Authenticate. In this example we intend for the user to send data within an HTTP POST method, passing a User object (which is a simple name\/password object). An AuthenticateResponse object is return via the ActionResult.<\/p>\n
The ActionResult<\/a> return value allows us to return HTTP 200 OK or using subclasses such as BadRequest<\/a> for an HTTP 400 and there are other derivations for other HTTP responses. <\/p>\nThe Action<> allows us to return a 200 OK without the need of using the Ok() method, although this can be used if preferred.<\/p>\n
When using different return responses it’s good to also document these by adding <\/p>\n
\r\n[ProducesResponseType(400)]\r\n<\/pre>\nThis indicates that the method may return an HTTP 400. This is useful for use with Open API tools such as Swagger.<\/p>\n
As can be seen in the Post method, the User object is expected within the method’s body and the HttpPost attribute declare the method uses HTTP POST, the method name is superfluous in terms of the REST API.<\/p>\n
The different HTTP methods<\/strong><\/p>\nThe code generated by the template creates a ValuesController with various HTTP methods, which I’ll recreate here for reference<\/p>\n
HTTP GET without URL parameters<\/em><\/p>\n\r\n[HttpGet]\r\npublic ActionResult<IEnumerable<string>> Get()\r\n{\r\n return new string[] { "value1", "value2" };\r\n}\r\n<\/pre>\nHTTP GET with URL parameters<\/em><\/p>\n\r\n[HttpGet("{id}")]\r\npublic ActionResult<string> Get(int id)\r\n{\r\n return "value";\r\n}\r\n<\/pre>\nHTTP POST without URL parameters<\/em><\/p>\n\r\n[HttpPost]\r\npublic void Post([FromBody] string value)\r\n{\r\n}\r\n<\/pre>\nHTTP PUT with URL parameters<\/em><\/p>\n\r\n[HttpPut("{id}")]\r\npublic void Put(int id, [FromBody] string value)\r\n{\r\n}\r\n<\/pre>\nHTTP DELETE with URL parameters<\/em><\/p>\n\r\n[HttpDelete("{id}")]\r\npublic void Delete(int id)\r\n{\r\n}\r\n<\/pre>\nHTTP HEAD<\/em><\/p>\n\r\n[HttpGet, HttpHead]\r\npublic IActionResult Head()\r\n{\r\n return Ok();\r\n}\r\n<\/pre>\nWe would request the headers using HttpHead along with an HttpGet.<\/p>\n