# Rest API (Intermediate)

## #1 REST API: Number of Drawn Matches 

In this challenge, the REST API contains information about football matches. The provided API allows querying matches by teams and year. The task is to get the number of matches for a given year that ended in a draw. A match is drawn when both teams scored the same number of goals.

To access a collection of matches played in a given year, perform an HTTP GET request to [https://jsonmock.hackerrank.com/api/football\_matches?year=\<year>\&page=\<page> ](#1-rest-api-number-of-drawn-matches)\
where \<year> is the year of the competition and \<page> is the page of the results to request. The results might be divided into several pages. Pages are numbered from 1.

For example, a GET request to\
[https://jsonmock.hackerrank.com/api/football\_matches?year=2011\&page=2](#1-rest-api-number-of-drawn-matches)\
returns data associated with matches in the year 2011 on the second page of the results.

The response to such a request is a JSON with the following 5 fields:

* `page`: The current page of the results.
* `per_page`: The maximum number of matches returned per page.
* `total`: The total number of matches on all pages of the results.
* `total_pages`: The total number of pages with results.
* `data`: An array of objects containing matches information on the requested page.

Each match record has several fields:

* `competition`: a string denoting the name of the competition
* `year`: an integer denoting the year when the match took place
* `round`: a string denoting the round the match belongs to (can be an empty string)
* `team1`: a string denoting the name of the first team in the match
* `team2`: a string denoting the name of the second team in the match
* `team1goals`: a string denoting the number of goals scored by team1 in the match
* `team2goals`: a string denoting the number of goals scored by team2 in the match

**Notice that the number of pages might be in hundreds, and it would take too much time to fetch the results from all of them and examine the scores of every match.** In order to overcome this issue, you are allowed to add an exact value of any of the match object fields to the URL query string in order to limit the number of results. This capability, if used correctly, can help you avoid examining individual match objects.

For example, performing a request to\
[https://jsonmock.hackerrank.com/api/football\_matches?year=2011\&team1goals=1\&page=2](#1-rest-api-number-of-drawn-matches)\
returns data associated with matches in the year 2011, where the first team scored 1 goal, on the second page of the results.

**Function Description**\
Complete the function *getNumDraws* in the editor below.

getNumDraws has the following parameter:\
&#x20;     int *year*: the year of the competition

The function must return an integer denoting the number of matches in the given year that ended up in a draw.

#### Constraints:

* You can safely assume that no team ever scored more than 10 goals.

#### Sample Case 0

| Input | Output |
| ----- | ------ |
| 2011  | 516    |

**Explanation**\
The year is 2011. There were 516 games in the year 2011 that ended in a draw, so that is the returned answer.

{% embed url="<https://github.com/gauravagrwal/HackerRank>" %}

## #2 REST API: Football Competition Winner's Goals&#x20;

In this challenge, the REST API contains information about football competitions and matches. The provided API allows querying competitions by name and year, and it also allows querying matches by competition and year. The task, for a given competition name and year, is to get the total number of goals scored by the team who won the competition.

To access a competition, perform an HTTP GET request to\
[https://jsonmock.hackerrank.com/api/football\_competitions?name=\<name>\&year=\<year>](#1-rest-api-number-of-drawn-matches)\
where \<name> is the name of the competition and \<year> is the year of the competition.

For example, a GET request to\
[https://jsonmock.hackerrank.com/api/football\_competitions?name=English Premier League\&year=2014](#1-rest-api-number-of-drawn-matches)\
returns data associated with the English Premier League in the year 2014.

The response to such a request is a JSON object that contains the property `data`, which is an array of competitions. In this case, the array will contain only a single item. The item has the following 5 fields:

* `name`: a string denoting the name of the competition
* `country`: a string denoting the name of the country of the competition
* `year`: an integer denoting the year of the competition
* `winner`: a string denoting the team that won the competition
* `runnerup`: a string denoting the team that was the runner-up in the competition

Below is an example of such a JSON object:

{% code overflow="wrap" %}

```json
{
  "name": "English Premier League",
  "country": "England",
  "year": 2014,
  "winner": "Chelsea",
  "runnerup": "Manchester City"
}
```

{% endcode %}

Next, to access a collection of matches played by a given team in a given competition and year, perform GET requests to\
[https://jsonmock.hackerrank.com/api/football\_matches?competition=\<competition>\&year=\<year>\&team1=\<team>\&page=\<page>](#1-rest-api-number-of-drawn-matches)\
[https://jsonmock.hackerrank.com/api/football\_matches?competition=\<competition>\&year=\<year>\&team2=\<team>\&page=\<page>](#1-rest-api-number-of-drawn-matches)

Here, \<competition> is the name of the competition, \<year> is the year of the competition, \<team> is the name of the team, and \<page> is the page of the results to request. The results might be divided into several pages. Pages are numbered from 1.

Notice that the above two URLs are different. The first URL specifies the team1 parameter (denoting the home team) while the second URL specifies the team2 parameter (denoting the visiting team). Thus, in order to get all the matches a particular team played in, you need to retrieve matches where the team was the home team and the visiting team.

For example, a GET request to\
[https://jsonmock.hackerrank.com/api/football\_matches?competition=UEFA%20Champions%20League\&year=2011\&team1=Barcelona\&page=2](#1-rest-api-number-of-drawn-matches)\
returns data associated with matches in the UEFA Champions League in the year 2011, where team1 (the home team) was Barcelona, on the second page of the results.

Similarly, a GET request to\
[https://jsonmock.hackerrank.com/api/football\_matches?competition=UEFA%20Champions%20League\&year=2011\&team2=Barcelona\&page=1](#1-rest-api-number-of-drawn-matches)\
returns data associated with matches in the UEFA Champions League in the year 2011, where team2 (the visiting team) was Barcelona, on the first page of the results.

The response to such a request is a JSON with the following 5 fields:

* `page`: The current page of the results.
* `per_page`: The maximum number of matches returned per page.
* `total`: The total number of matches on all pages of the results.
* `total_pages`: The total number of pages with results.
* `data`: An array of objects containing matches information on the requested page

Each match record has several fields, but in this task only the following 4 are relevant:

* `team1`: a string denoting the name of the first team in the match
* `team2`: a string denoting the name of the second team in the match
* `team1goals`: a string denoting the number of goals scored by team1 in the match
* `team2goals`: a string denoting the number of goals scored by team2 in the match

**Function Description**\
Complete the function *getWinnerTotalGoals* in the editor below.

getWinnerTotalGoals has the following parameters:\
&#x20;    string *competition*: the name of the competition\
&#x20;    int *year*: the year of the competition

The function must return an integer denoting the total number of goals scored in all matches in the given competition by the team who won the competition.

#### Sample Case 0

| Input                                  | Output |
| -------------------------------------- | ------ |
| <p>UEFA Champions League <br>2011 </p> | 28     |

**Explanation**\
The competition is UEFA Champions League and the year is 2011. One of the API endpoints can be used to determine that team Chelsea won this competition. Then, another endpoint can be used to find out that the total number of goals scored by Chelsea during this competition is 28, which is the required answer.

{% embed url="<https://github.com/gauravagrwal/HackerRank>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dailyjournal.gitbook.io/solutions/hackerrank-solutions/certify/rest-api-intermediate.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.