# Setting Headers

## When do I use an API?

Every time you send a request to an endpoint it takes time and bandwidth. From your perspective, as an app developer you want to minimise wait times in your app. From the perspective of your API developer you want to keep your bandwidth usage as low as possible - especially if it's something they're paying for and you're using for free. Thankfully these issues are two sides of the same coin and 

By the end of this lesson you'll understand how to:

1. Maximise app speeds while minimising API calls. 
2. Set  WebAPI headers. 

### Overview

{% hint style="success" %}
**Remix link:** [<mark style="color:blue;">**https://x.thunkable.com/projectPage/620e5675396bbd001066d68a**</mark>](https://x.thunkable.com/projectPage/620e5675396bbd001066d68a)
{% endhint %}

According to [their docs](https://icanhazdadjoke.com/api), *icanhazdadjoke.com can be used as an API for fetching a random joke, a specific joke, or searching for jokes in a variety of formats.*

<figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2F1jgrnz27esXrPZrYzzre%2Fjotd.gif?alt=media&#x26;token=6fc3832a-f4ae-4ba6-b567-eaff49c49cfe" alt=""><figcaption></figcaption></figure>

### Setting API Headers

The API allows us to get jokes in HTML, JSON or plain text format. In order for us to specify *which* format we would like the response in we need to use a **header.** In the WebAPI drawer, there are four different properties we can set; Body, Headers, QueryParameters and URL. Going back to the API docs, we are asked to specify an `Accept` header and a `User-Agent` header. To request a response in JSON format from the API we set the value of the Accept header to `application/json`. The user agent header is used as a way for us to identify ourselves to the API developer. Recall that this is a free service and we don't want to take advantage of the generosity of the developer. In this case I've used an email address since it gives the developer a way to contact me directly if there are too many calls being made.&#x20;

<figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FIgnUEMeZHzjnkav4KLq4%2Fjaas_headers.png?alt=media&#x26;token=db69864b-5f8c-4ab0-915c-cb2c43747cea" alt=""><figcaption></figcaption></figure>

### GET Jokes

The API request is quite similar to the one we saw in the previous tutorial. After specifying the URL and the Headers we send a `Get` request to the API. The `if error then do` block is for basic error handling and should not be omitted. To display the text of the joke itself we get the `joke` property from the response object.&#x20;

<figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2F2dlmZu3x05Eho1bEZ2GS%2Fjaas_get_joke.png?alt=media&#x26;token=db8a7092-5d3d-4b03-89d4-ca172a20c990" alt=""><figcaption></figcaption></figure>

## Fetching a random joke as JSON

<mark style="color:blue;">`GET`</mark> `https://icanhazdadjoke.com/`

#### Headers

| Name       | Type   | Description                                                                                                                                                                          |
| ---------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Accept     | String | Request a response in HTML, JSON or plain text format. Defaults to text/plain if not specified.                                                                                      |
| User-Agent | String | A good user agent should include the name of the library or website that is accessing the API along with a URL/e-email where someone can be contacted regarding the library/website. |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
  "id": "R7UfaahVfFd",
  "joke": "My dog used to chase people on a bike a lot. It got so bad I had to take his bike away.",
  "status": 200
}
```

{% endtab %}
{% endtabs %}

### Read the Joke

Once the joke is displayed on screen we can temporarily "deactivate" the Get Joke button. This serves two purposes. First of all, it gives the user a moment to read (and appreciate) the joke and secondly it prevents users from making multiple requests to the API per second by repeatedly clicking on the button. In the example below we add a pause of 5 seconds, which means that at most a user can request 12 jokes per minute. This still a good number of jokes, and a lot better than not having any pause at all.&#x20;

<figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2FLRZx8aJzlYerjB9sukVW%2Fjaas_read_joke.png?alt=media&#x26;token=baba1be2-ef32-400f-9aa8-15e48a863f9f" alt=""><figcaption></figcaption></figure>

### Ba Dum Tss

Finally, for a bit of visual interest, we add in a random emoji reaction. This is obviously a pretty simple thing to do, but you can easily expand on this by adding some sound effects or a laugh track to your app.

<figure><img src="https://1223006790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LAn5scXl2uqUJUOqkJo-84897653%2Fuploads%2F5372AVQcPRn6jANT1ONa%2Fjaas_show_reaction.png?alt=media&#x26;token=0414c02e-1e8b-4b56-8a9f-f4c409a76a21" alt=""><figcaption></figcaption></figure>

## Conclusion

In this section we've looks at why it's a good idea to use a proper API, how to set the URL and make a GET request, how to implement basic error handling, how to convert a JSON response to an Object and pull information out of that object and finally we learned how to set API headers and implement some basic rate limiting.&#x20;

In the next section we'll increase the complexity slightly and learn how to use APIs that require some basic auth or an access token before we can perform any other operations.&#x20;

### Questions?

If you have any questions about this tutorial, please post them in this topic over in the Thunkable Community

{% hint style="info" %}
**Community Link:** [<mark style="color:blue;">**https://community.thunkable.com/t/jokes-api-tutorial**</mark>](https://bit.ly/3tQsuBz)
{% endhint %}