This is the "Web API with AJAX" article series. In this article series we are explaining Web API and ajax() method to consume it. We have learned the POST, GET, PUT and DELETE methods. You can read them here.
This article explains the getJSON() function of jQuery and how to use the getJSON() function to consume JSON data from the Web API. We know that the Web API function can any type of data, in other words the content negotiation happens very smoothly. So, let's try a few examples.
Client code to implement getJSON() function
In this example we will configure the getJSON() function that will consume data from the Web API. Have a look at the following code.
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="APICall.aspx.cs" Inherits="WebApplication1.APICall" %>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
<script src="jquery-1.7.1.js" type="text/javascript"></script>
<script>
$(document).ready(function () {
$("#Save").click(function () {
$.getJSON('http://localhost:3413/api/person', function (data) {
console.log(data);
});
});
});
</script>
</head>
<body>
<input type="button" id="Save" value="Save Data" />
</body>
</html>
The getJSON() function takes three parameters (generally) but in this example we are passing an URL and a success callback function as an argument. So, when data is returned it will be held by a callback function and will get logged to the console.
Create Web API to return JSON data
Now we will create a Web API that will return JSON data. Here is the code example.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Web.Http;
namespace WebApplication1.WebAPI
{
public class personController : ApiController
{
[HttpGet]
public List<string> Post()
{
List<string> List = new List<string>();
List.Add("Sourav Kayal");
List.Add("Ajay Joshi");
List.Add("Nontey Banerjee");
return List;
}
}
}
In this example we are returning a List of strings but the fact that needs to be explained is that in the return we are not converting to JSON format. This is the beauty of the Web API. At the
time of content negotiation the return data is exchanged in JSON format, there is no need to convert it explicitly. Here is the output of the example above.
![JSON data]()
Return complex data in JSON format
In the above example we have returned a string (primitive type) and in this example we will return complex data, in other words an object. Here is the implementation of a client program that will consume complex data in JSON format.
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="APICall.aspx.cs" Inherits="WebApplication1.APICall" %>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
<script src="jquery-1.7.1.js" type="text/javascript"></script>
<script>
$(document).ready(function () {
$("#Save").click(function () {
$.getJSON('http://localhost:3413/api/person', function (data) {
console.log(data);
});
});
});
</script>
</head>
<body>
<input type="button" id="Save" value="Save Data" />
</body>
</html>
The function is very simple, just taking two arguments. The first one is a URL and the second one is a callback function.
Create Web API to return complex data
In this example we will configure a Model call and we will create a set of objects to that class. The function will return data in JSON format.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Net.Http;
using System.Web.Http;
namespace WebApplication1.WebAPI
{
public class person
{
public string name { get; set; }
public string surname { get; set; }
}
public class personController : ApiController
{
[HttpGet]
public List<person> Post()
{
List<person> List = new List<person>();
person p1 = new person();
p1.name = "Sourav";
p1.surname = "Kayal";
List.Add(p1);
person p2 = new person();
p2.name = "Sourav";
p2.surname = "Kayal";
List.Add(p2);
return List;
}
}
}
We have implemented a Post() method to return data, anyway we can use a Get() method also to return JSON data. Here is the output of the example above.
![Web-API to return complex data]()
Conclusion
In this article we have learned how to use the getJSON() function to get JSON data from a Web API RESTful service. I hope you have understood the concept of the getJSON() function.