La problématique
Les faits de Chuck Norris sont des faits satiriques au sujet de l'artiste martial et acteur Chuck Norris qui sont devenus un phénomène Internet et qui sont par conséquent devenus répandus dans la culture populaire. Les «faits» sont normalement des affirmations hyperboliques absurdes concernant la ténacité, l'attitude, la virilité, la sophistication et la masculinité de Norris. Partant de ce constat, une petit malin a écrit une API vous permettant de demander un fait de Chuck. Et le webservice vous répond (en anglais) sur un fait. Drôle, humoristique, sympatique, mais a qui peut donc bien profiter cette API que je souhaitais vous faire partager ?
Le service interrogé
Le service interrogé porte comme nom (de domaine) chucknorris.io. On peut donc imaginer que l'auteur est proche de Chuck Norris, ou fan (bon, je dois l'avouer, même si je ne regarde plus, je peux comprendre - Personne n'est parfait, même si je préfère, et de loin Jamy GORUMAUD à la TV).
Le service, ou plutot les services, sont au nombre de 4 : on peut faire 4 interrogations différentes :
- Récupérer une blague de Chuck Norris au format JSON au hasard
- Récupérer une blague aléatoire de Chuck Norris dans une catégorie donnée.
- Récupérer la liste des catégories dans lesquelles sont classées les blagues de Chuck Norris
- Faire une recherche de blague de chuck, en spécifiant un mot-clef de recherche
Bon, y'a de quoi faire, nous allons voir les appels. Le service est disponible à l'adresse https://api.chucknorris.io et la documentation est accessible à l'adresse https://api.chucknorris.io/#! (c'est en fait le même edroit)
Le résultat
Nous allons regarder tout ca.
1. Récupérer une blague de Chuck Norris au format JSON au hasard
L'appel de l'API est simple et je ne vois pas de commentaires à ajouter, si ce n'est que le résultat renvoyé est du JSON. : https://api.chucknorris.io/jokes/random
2. Récupérer une blague aléatoire de Chuck Norris dans une catégorie donnée
Alors là, effectivement, c'est un peu plus compliqué :-), il faut passer un parmètre (la catégorie, je reviens dessus plus bas) en anglais toujours :
https://api.chucknorris.io/jokes/random?category={category}Essayons avec la catégorie "food" :
3. Récupérer la liste des catégories dans lesquelles sont classées les blagues de Chuck Norris
Alors, allez vous mem dore, "oui c'est bien beau, mais comment puis-je connaitre la liste des tubriques que je peux passer en paramètre ? (je me suis posé la même question). Et bien, une API vous répond à cette question : https://api.chucknorris.io/jokes/categories
4. Faire une recherche de blague de chuck, en spécifiant un mot-clef de recherche
Et pourquoi ne spécifierait on pas un mot clefs, comme pour une recherche Google, c'est ce qu'il y a de plus naturel de nos jours? Attention toutefois, l'API n'est pas aussi complexe que Google et iul faut spécifier des mots clefs proches de la thématique de Chuck Norris. Afin d'écrrie cet article, j'ai testé cats, animals, sex et girls... mais j'ai joujours eu des reponses. Attention toutefois, en spécifiant des mots clefs, les réponses sont parfois des anecdotes sur l'éacteur.