Request and Response Models

1public IHttpActionResult Get(int id)                          // id from the route
2public IHttpActionResult Search([FromUri] ProductQuery query) // class from the query string
3public IHttpActionResult Post(CreateProductRequest request)   // class from the JSON body
4public IHttpActionResult Rename(int id, [FromBody] string name)

1using System.Collections.Generic;
2using System.Linq;
3using System.Web.Http;
4using Newtonsoft.Json;
5using Newtonsoft.Json.Serialization;
6

7// App_Start/WebApiConfig.cs
8public static class WebApiConfig
9{
10    public static void Register(HttpConfiguration config)
11    {
12        config.MapHttpAttributeRoutes();
13

14        config.Formatters.Remove(config.Formatters.XmlFormatter);      // JSON only
15        var json = config.Formatters.JsonFormatter.SerializerSettings;
16        json.ContractResolver = new CamelCasePropertyNamesContractResolver();
17        json.NullValueHandling = NullValueHandling.Ignore;
18        json.DateTimeZoneHandling = DateTimeZoneHandling.Utc;
19    }
20}
21

22public class ProductQuery                 // bound from ?category=Books&maxPrice=500
23{
24    public string Category { get; set; }
25    public decimal? MaxPrice { get; set; }
26}
27

28public class CreateProductRequest         // bound from the JSON body
29{
30    public string Name { get; set; }
31    public decimal Price { get; set; }
32}
33

34public class ProductResponse
35{
36    public int Id { get; set; }
37    public string Name { get; set; }
38    public decimal Price { get; set; }
39    public string Badge { get; set; }     // null → left out of the JSON
40}
41

42[RoutePrefix("api/products")]
43public class ProductsController : ApiController
44{
45    [HttpGet, Route("")]
46    public IHttpActionResult Search([FromUri] ProductQuery query)
47    {
48        return Ok(new { query.Category, query.MaxPrice });
49    }
50

51    [HttpPost, Route("")]
52    public IHttpActionResult Create(CreateProductRequest request)
53    {
54        var response = new ProductResponse { Id = 7, Name = request.Name, Price = request.Price };
55        return Created("api/products/7", response);
56    }
57

58    [HttpPut, Route("{id:int}/name")]
59    public IHttpActionResult Rename(int id, [FromBody] string newName)
60    {
61        return Ok(new { id, newName });
62    }
63

64    [HttpGet, Route("language")]
65    public IHttpActionResult Language()
66    {
67        IEnumerable<string> values;
68        var language = Request.Headers.TryGetValues("Accept-Language", out values) ? values.First() : "en";
69        return Ok(new { language });
70    }
71}

GET  /api/products?category=Books&maxPrice=500
     → 200 {"category":"Books","maxPrice":500.0}

POST /api/products   Content-Type: application/json   {"name":"Pen","price":20}
     → 201 {"id":7,"name":"Pen","price":20.0}          (badge is null, so it is omitted)

PUT  /api/products/7/name   Content-Type: application/json   "Gel Pen"
     → 200 {"id":7,"newName":"Gel Pen"}

GET  /api/products/language   Accept-Language: hi-IN
     → 200 {"language":"hi-IN"}