Découvre 7 APIs cools et insolites!

Découvre 7 APIs cools et insolites!

Les êtres humains apprennent mieux en jouant.

Peu importe votre niveau, débutant ou habitué, cet article vous donnera 7 APIs drôles et absurdes avec lesquelles vous amuser !

Si vous n’avez jamais écrit une ligne de code, ne vous inquiétez pas ! Nous vous montrerons comment ça fonctionne. Pour les plus expérimentés, n’hésitez pas à passer directement à la partie “Les 7 APIs à découvrir” ;)

C’est quoi une API?

API est l’acronyme de “Application Programming Interface” (Interface de Programmation d’Application). C’est une méthode de communication entre deux programmes. Ils peuvent être exécutés à partir du même ordinateur ou non, ça n’a pas vraiment d’importance.

Il y a plusieurs types d’APIs - le terme est très large. Aujourd’hui nous allons nous concentrer sur les APIs REST.

Les APIs REST suivent un pattern qui définit comment l’information sera transmise d’un ordinateur à un autre. Celui qui demande la data est appelé le client, et celui qui la reçoit s’appelle le serveur (server) : c’est le cycle de requête-réponse (request-response).

Si vous voulez une définition approfondie avant de jeter à l’eau, jetez un œil à cette explication détaillée des APIs REST.

A savoir avant de débuter :

Il y a plusieurs manières de configurer notre environnement de travail :

• La manière la plus simple est d’utiliser votre navigateur internet.
• Vous pouvez aussi utiliser un outil appelé Postman.
• Ou bien… Vous pouvez écrire un peu de code ! Mon langage préféré est le JavaScript - le langage de programmation le plus populaire dans le monde. Si vous souhaitez apprendre comment appeler des APIs à partir de votre code JavaScript, allez voir cet article sur comment faire des requêtes HTTP en Node.js

Les 7 APIs à découvrir

Dog API

La Dog API vous permet de chercher des photos de chien, de trouver des informations sur les différentes races existantes et plus encore…

Pour l’essayer, entrez https://api.thedogapi.com/v1/images/search dans votre moteur de recherche. Bravo ! Vous venez de faire un appel API ! 🎉 🐶

Sur la page, vous devriez voir un code qui ressemble à ça :

Mais qu’est-ce que ça veut dire ? La plupart des APIs REST vous donnent une réponse au format JSON (JavaScript Object Notation). L’information vient sous forme de paire de clés et valeurs qui sont séparées d’un deux-points “:”.

Référons-nous à l’exemple de réponse API au-dessus : pour la clé width, la valeur serait 560.

Si vous copiez la valeur url à partir de ce code et que vous le chargez dans votre navigateur de recherche, vous devriez voir des gifs ou des images à croquer !

Allez voir la documentation sur la Dog API pour apprendre ce que vous pouvez faire de plus !

API Pokemon

Supposément, PokeApi gère 17 millions de requêtes par mois.” Attrapez-les tous “

Cette API renvoie seulement les datas liées à la franchise du jeu vidéo Pokemon. Puisqu’il y a eu de nombreux films, séries et bandes dessinées autour du jeu, l’API pourrait être surchargée si elle devait tout couvrir. Même en se cantonnant juste aux jeux vidéos, il y a plus de 9000 informations différentes dans la base de données de PokeApi.

Essayons d’explorer les paramètres des espèces Pokemon. Pour avoir une liste de tous les Pokémon non-genrés, il faudrait faire un appel API : https://pokeapi.co/api/v2/gender/3/.

Cela nous renvoie une longue liste : j’ai appris qu’il y avait actuellement 104 espèces non-genrées de Pokemon. 😲Il faut savoir que Poke-gender est super compliquée et n’est pas rétro-compatible entre les différentes versions du jeu.

PokeApi est open-source. Vous pouvez parcourir le code ou y contribuer sur GitHub.

API Fun translations

Combien de langages chers aux geeks peuvent être compressés en une API ? Un certain nombre apparemment ! Fun translations vous permet de traduire de l’anglais vers le :

• Klingon
• Le langage de Yoda
• Pig Latin
• Cockney
• Ermahgerd

Pour essayer les traductions API dans le navigateur, vous avez besoin de url-encode le texte pour que chacun des caractères spéciaux puisse être compris de façon universelle par n’importe quel serveur ; bonne nouvelle puisque le navigateur s’en charge pour vous !

Si vous collez “https://api.funtranslations.com/translate/doge.json?text=Good morning” dans la barre URL d’un moteur de recherche, cela se transformera en “https://api.funtranslations.com/translate/doge.json?text=Good%20morning” lorsque vous chargerez la page.

Vous verrez une réponse comme ci-dessous :

affirmations.dev

Au début, lorsque mon thérapeute a suggéré que j’essaie l'affirmation de soi (ADS) , j’ai levé les yeux au ciel, si ce n’est soupiré ! Mais j’ai tout de même joué le jeu et ai donné une chance à cette méthode. Finalement, ces affirmations m’ont été super utiles pour combattre le syndrome de l’imposteur !

Alors, j’ai créé une petite API pour fournir des affirmations positives à la demande et ai même construit mon premier projet hardware par-dessus.

Pour avoir une affirmation, rentrez simplement “https://www.affirmations.dev/” dans la barre de recherche et recevez une réponse motivante comme ci-dessous :

Affirmation.dev est open-source. Si vous êtes timide et que vous n’osez pas trop coder, vous pouvez tout de même contribuer en donnant de nouvelles affirmations ! Toute participation est la bienvenue ! 💖

HTTP Status Cats

Comme nous avons inclut une API sur les chiens dans ce top 7, nous étions aussi obligés de satisfaire les amoureux des chats ! 😻 Quand vous faites un appel à une API REST, celle-ci renvoie un “code de statut” qui indique si la demande a été un succès - ou non - et pourquoi.

Http.cat vous redirige sur une photo de chat qui illustre chaque code de statut. Pour voir la plus hilarante (en toute objectivité bien-sûr 🙄), allez sur http.cat/418.

Les “blagues de papa”

Sans mentir, ce sont les “blagues de papa" (Dad Jokes) qui m'ont fait avoir ce job chez Twilio. J’ai écrit ce petit programme qui utilise l’API des blagues de papa (Dad Jokes API), puis j’en ai démontré l’utilisation et nous en sommes ici !

Hélas, il n’y a aucun moyen simple d’essayer cette API dans un moteur de recherche. Si vous rentrez directement l’URL de l’API, cela charge une page web entière, au lieu de renvoyer une réponse codée avec la blague spécifique. Si vous avez accès à un terminal, vous pouvez essayer d'exécuter ce code à depuis la ligne de commande :

De cette façon, vous pourrez chercher une blague en particulier.

Pour les plus expérimentés d’entre vous, la Dad Jokes API a un paramètre qui fournit des réponses formatées pour Slack. Si ça vous démangeait de faire votre première Slack App, quel meilleur moment que maintenant?! Cette API parle aussi le GraphQL, si jamais vous cherchiez une excuse pour vous plonger dedans ;)

L’énorme collection d’APIs scientifiques de la NASA

Il y a toute une panoplie d’APIs sur api.nasa.gov. Les plus populaires sont celles en lien avec la photo :

• Vous pouvez avoir des photos transmises par le Mars Rover. Sam Agnew a créé une appli Twilio pour avoir l’image du jour en direct des robots sur la planète rouge !
• April Speight a écrit un post en utilisant l’API de l’image du jour, qui vous permet de vous envoyer cette photo via Azure Functions et Twilio.

Néanmoins, il y des APIs autres que la recherche de photos comme :

• Recherche des astéroïdes les plus proches de la Terre.
• Requêter la base de données sur les exoplanètes

Pour essayer cette API, entrez dans votre navigateur : https://api.nasa.gov/planetary/apod?api_key=DEMO_KEY et copiez la valeur url de la réponse.

Pour conclure !

Un énorme merci aux créateurs et aux mainteneurs de ces projets légers et amusants ! 💜

J’espère que ces APIs insolites vous auront motivé à construire quelque chose, ou même simplement apporté une lueur de joie dans vos yeux !

Êtes-vous déjà tombés sur d’autres APIs qui donnent le sourire? Ou bien avez-vous déjà construit un projet intéressant avec une API ? Si oui n’hésitez à me contacter sur Twitter : @annthurium