Utilisation de l'API de Twitter
Sur cette page, tu verras comment utiliser l'API de Twitter avec le module Birdy ! ;)
Pour commencer, voici le lien de la documentation de l'API de Twitter : https://developer.twitter.com/en/docs/api-reference-index
Cette page contient tous les EndPoints de l'API : toutes les fonctionnalités de cette dernière s'y trouvent, rangées en catégories.
Par exemple, la catégorie à droite est celle avec les EndPoints gérant les Tweets de manière générale : créer un tweet/retweet, en supprimer un, voir les tweets des gens, etc... :)
Lorsque l'on clique sur un EndPoint, on obtient toutes ses informations.
La première d'entre elles est son nom complet, ainsi que la méthode de la requête (soit GET, soit POST), avec la description en dessous.
Ensuite, quand on va un peu plus bas, on a la liste des paramètres qu'on peut donner à la requête. Par exemple, pour cet EndPoint, qui consiste à écrire un nouveau Tweet, le seul paramètre qui nous intéresse est celui nous permettant de choisir le texte de notre Tweet :)
Utilisation de l'API avec le module Birdy
Le module Python dont on va se servir pour utiliser cette API est extrêmement simple... :D
Il s'appelle Birdy, et a été pensé pour être le plus simple d'utilisation possible.
Dans cette section de la page, tu verras comment te connecter avec tes tokens sur Birdy, comment utiliser un endpoint, et comment traiter une réponse de l'API :)
Se connecter avec ses tokens pour avoir accès à l'API
Cette étape est la plus simple ! Il te suffit de faire ces 3 choses :
Pour pouvoir utiliser l'API Twitter, nous devons importer le module :
Créer 4 variables, une pour chacun de tes tokens
Et enfin, il faut que nous mettions toutes ces variables pour s'authentifier en tant que client.
Utiliser un EndPoint
Ensuite, et c'est là que toute la magie de Birdy opère, pour se servir d'un EndPoint il faut utiliser le client qu'on a créé de la façon suivante.
Attention, c'est du faux code pour expliquer la structure de la ligne !!
Dans cet exemple :
- CATEGORIE correspond à la catégorie de l'EndPoint
- ENDPOINT correspond au nom de l'EndPoint
- METHODE correspond à la méthode de la requête : GET ou POST
- PARAMETRES correpond aux paramètres de la requête
Si on reprend l'EndPoint de toute à l'heure pour poster un nouveau Tweet, voici comment on doit lire la doc :
Et voici donc comment on va s'en servir avec Birdy ! On voit bien qu'on a écrit la ligne de code en mettant exactement les mêmes informations que sur la doc :)
Comment traiter une information envoyée par l'API ?
Certains EndPoints te permettront de récupérer des informations : par exemple, si on fait une requête sur l'EndPoint GET users/show, l'API nous enverra toutes les informations de l'utilisateur qu'on aura demandé.
Pour récupérer cette information correctement, on doit donc la stocker dans une variable !
Dans l'exemple ci-dessous, je demande à l'API les informations du compte de NintendoFrance, et je les stocke dans une variable nintendo :)
Ce qu'il faut savoir, c'est que, en général, les API nous envoient ces informations bien rangées d'une façon spéciale, sous un format spécial.
On appelle ça le JSON (pas besoin de se souvenir du nom, nous on va appeler ça de la Data ! :p).
Jetons un coup d’œil à cette data du coup...
Et ouais, on est d'accord, c'est pas très joli, et ça a pas l'air très rangé... Mais ça l'est !! Pour mieux voir ça, je vous invite à copier/coller tout ceci sur ce site, qui va tout bien organiser comme il faut : http://jsonviewer.stack.hu/
Il suffit de copier les infos (de la première à la dernière accolade !!) dans la zone de texte, et de cliquer sur Format !
Et on est d'accord que c'est déjà un peu mieux rangé pour nous autres humains ;)
Ce qu'on remarquera, c'est qu'il y a plein de "variables" différentes, chacune avec leur nom et leur valeur.
Par exemple, la première c'est id, et sa valeur est 491500016... Pas très utile comme info ça.
La troisième par contre, c'est name, et sa valeur est NintendoFrance... Ah c'est déjà plus intéressant ça ! :)
En fait, si on regarde touuuuute la data, on s’apercevra qu'il y a vraiment plein de variables, certaines plus utiles que d'autres :)
Maintenant, imaginons que nous voulons afficher seulement la description parmi toutes ces variables. Eh bien, c'est encore une fois extrêmement simple avec Birdy ! :)
Il suffit juste d'écrire la ligne ci-côté :
Et le tour est joué ! :)
Voici le code complet de cet exemple