# Random

## Random joke

<mark style="color:blue;">`GET`</mark> `https://api.night-api.com/jokes`

Génère une blague aléatoirement.

#### Query Parameters

| Name     | Type   | Description                                            |
| -------- | ------ | ------------------------------------------------------ |
| disallow | string | To avoid the generation of certain categories of jokes |

#### Headers

| Name                                            | Type   | Description  |
| ----------------------------------------------- | ------ | ------------ |
| authorization<mark style="color:red;">\*</mark> | String | Your API key |

{% tabs %}
{% tab title="200 Random joke find." %}

```javascript
{
    "status": 200,
    "content": {
        "id": 44,
        "type": "global",
        "blague": "Que dit un canard quand il va aux toilettes ?",
        "reponse": "Je vais au petit coin."
    }
}
```

{% endtab %}

{% tab title="400 Bad disallow query" %}

```javascript
{ 
    status: 400, 
    error: "Bad disallow query provided"
}
```

{% endtab %}
{% endtabs %}

**Lists of available categories:**

* global
* dev
* dark
* limit
* beauf
* blondes

<br>

```javascript
const axios = require("axios");

axios.get('https://api.night-api.com/jokes', {
    headers: {
        authorization: "API token"
    }
})
.then(function (response) {
    console.log(response.data);
})
```

\
Or with the NPM module

<pre class="language-javascript"><code class="lang-javascript">const { NightAPI } = require('night-api');
<strong>const api = new NightAPI('YOUR_API_KEY');
</strong>
const blague = await api.jokes.random(); // Return: Promise
</code></pre>

\
With this method, you can specify certain categories that you do not want to receive.

```javascript
const { NightAPI } = require('night-api');
const api = new NightAPI('YOUR_API_KEY');

const blague = await api.jokes.random({
  disallow: ['dark', 'limit']
}); // Return: Promise
```