BLAGUES API

C'est l'histoire d'un pingouin qui respirait par les fesses.
Un jour il s'est assis et il est mort.

Qu’est ce que Blagues API ?

Blagues API est une API de blagues, rassemblant les meilleures blagues avec un total de 461 blagues françaises.

Des blagues proposées par la communauté et catégorisées.

L’API est accessible gratuitement et rassemble sur le discord une communauté francophone.

Utilisation

Différentes routes vous sont rendues disponibles afin d'adapter l'api a votre projet. Les différents mots clés vous permettront de récupérer une blague aléatoirement dans un thème ou type de blague spécifique.

BLAGUE ALÉATOIRE

GET /api/random

BLAGUE ALÉATOIRE CATÉGORISÉ

GET /api/type/:type:/random // type: global, dev, dark, limit, beauf, blondes

BLAGUE PAR ID

GET/api/id/:id:

Utilisation avancé

Parfois certains types d'humour dérangent certaines personnes, hors blagues-api est une api publique qui s'est donné comme mission de convenir aux tous types d'humour. C'est pour cela que nous vous offrons la possibilité de filtrer les blagues et donc d'en retirer celles qui font partie d'une catégorie qui ne vous convient pas.

UTILISATION D'UN SEUL FILTRE

GET /api/random?disallow=dark

UTILISATION DE PLUSIEURS FILTRES

GET /api/random?disallow=dark&disallow=limit&disallow=dev

Authentification

L'api de blagues utilise un token d'authentification Bearer pour les requêtes. Vous pouvez le gérer depuis votre profil.
Les requêtes doivent toutes être effectuées via HTTPS. Tous les appels effectuées sans authentification ou en HTTP échoueront.
Si vous avez des difficultées à obtenir un certificat HTTPS, voici Certbot, un outil qui permet d'en obtenir un gratuitement !

curl https://www.blagues-api.fr/api/random \
-H "Authorization: Bearer [TOKEN]" \

Exemple

Voici un exemple sous forme de cas d'utilisation de l'api dans le cas où l'on souhaite récupérer une blague aléatoirement dans le répertoire toute catégorie confondue

JAVASCRIPT
fetch('https://www.blagues-api.fr/api/random', {
    headers: {
        'Authorization': `Bearer [TOKEN]`
    }
})
.then(response => response.json())
.then(data => {
    console.log(data)
    /* Expected output:
    { 
        "id": 1, 
        "type": "dev",
        "joke": "Un développeur ne descend pas du métro.", 
        "answer": "Il libère la RAM..."
    }
    */
})

Remerciments

Un grand merci à toute la communauté qui a contribué au projet que ça soit sur le discord ou sur le github en apportant leurs ajouts et modifications au code de l'api, mais également à tous ceux qui ont proposé leurs blagues afin d'agrandir le répertoire de l'api. Le nombre de blagues françaises continuent de grandir de jours en jours. Merci à vous !