This repo provides a starter web application with supporting backend application for demonstrating how to use the XMLHttpRequest browser object for accessing a Web API.
The Web API exposed here provides information about Nobel Prize Winners and Nobel Laureates, i.e. persons or organizations that have been awarded a Nobel Prize.
Although there is an online NobelPrize.org API, it was chosen for this repo to provide the Laureate and Prize information through a local backend, so that the application can be demonstrated and extended without the need for an Internet connection. However, the actual Nobel Prize data used here was downloaded in JSON data format through the official API.
To install this application, follow these steps:
-
(Optionally) fork this repo to your own GitHub account.
-
Clone the (forked) repo to your local machine.
-
Open the repo folder in VSCode.
-
Open the Integrated Terminal and type:
npm install
-
Start the backend with the following command:
npm start
-
Open your browser and type the following in the address bar:
http://localhost:3000
This will open the web application. The application as cloned is unfinished. It just displays this screen:
This folder contains the frontend application, initially consisting of these files:
- index.html
- app.js
- style.css
This is where you should make modifications, such as adding an XMLHttpRequest
and handling the returned data.
This folder contains the supporting backend application. For this exercise you should not need to modify anything in here. The backend makes use of the json-server node package.
This folder just contains the picture used in this README file.
The backend application exposes the following Web API end point for Nobel Prizes:
http://localhost:3000/prizes
This particular end point returns information about all Nobel Prizes.
You can query the endpoint for more specific data by adding a query string to the url. For instance:
http://localhost:3000/prizes?category=economics
The information returned has the following JSON format (only the first two matching prize winners are shown).
[
{
"year": "2017",
"category": "economics",
"laureates": [
{
"id": "949",
"firstname": "Richard H.",
"surname": "Thaler",
"motivation": "\"for his contributions to behavioural economics\"",
"share": "1"
}
]
},
{
"year": "2016",
"category": "economics",
"laureates": [
{
"id": "935",
"firstname": "Oliver",
"surname": "Hart",
"motivation": "\"for their contributions to contract theory\"",
"share": "2"
},
{
"id": "936",
"firstname": "Bengt",
"surname": "Holmström",
"motivation": "\"for their contributions to contract theory\"",
"share": "2"
}
]
}
]
The backend application exposes the following Web API end point for Nobel Laureates:
http://localhost:3000/laureates
As specified, this particular end point returns information about all Nobel Laureates.
You can query the endpoint for more specific data by adding a query string to the url. For instance:
http://localhost:3000/laureates?surname=Dylan
The information returned has the following JSON format:
[
{
"id": "937",
"firstname": "Bob",
"surname": "Dylan",
"born": "1941-05-24",
"died": "0000-00-00",
"bornCountry": "USA",
"bornCountryCode": "US",
"bornCity": "Duluth, MN",
"gender": "male",
"prizes": [
{
"year": "2016",
"category": "literature",
"share": "1",
"motivation": "\"for having created new poetic expressions within the great American song tradition\"",
"affiliations": [
[]
]
}
]
}
]
For information on how to construct other query strings, e.g. to filter information using specific criteria check the documentation of json-server here.