{"id":1038,"date":"2011-02-06T19:14:28","date_gmt":"2011-02-06T17:14:28","guid":{"rendered":"http:\/\/linux.leunen.com\/?p=1038"},"modified":"2011-02-06T19:14:28","modified_gmt":"2011-02-06T17:14:28","slug":"utiliser-twitter-dans-une-application","status":"publish","type":"post","link":"https:\/\/www.leunen.com\/linux\/2011\/02\/utiliser-twitter-dans-une-application\/","title":{"rendered":"Utiliser Twitter dans une application"},"content":{"rendered":"

Il est assez facile de cr\u00e9er un petit script ou d’inclure dans une application la possibilit\u00e9 d’envoyer un message sur Twitter m\u00eame si depuis quelques mois Twitter impose un syst\u00e8me d’authentification plus compliqu\u00e9 que la simple identification par identificateur\/mot-de-passe utilis\u00e9e pr\u00e9c\u00e9demment. OAuth<\/em> est un syst\u00e8me d’identification qui repose, pour sch\u00e9matiser, sur un syst\u00e8me de clef publique et de clef priv\u00e9e. Il faut que l’application qui va utiliser Twitter soit enregistr\u00e9e et autoris\u00e9e par Twitter. De m\u00eame, il faut que le titulaire du compte Twitter, que l’application va utiliser, ait donn\u00e9 son autorisation. Ce n’est que dans ce cas que l’application recevra le token<\/em> n\u00e9cessaire \u00e0 l’acc\u00e8s au compte Twitter. <\/p>\n

Il existe plusieurs modules python permettant d’utiliser Twitter. Par exemple python-tweepy<\/em> ou python-twitter<\/em>. C’est ce module-l\u00e0 que je vais utiliser pour l’avoir d\u00e9j\u00e0 tester dans le pass\u00e9 lorsque Twitter n’utilisait que la simple authentification. Jusqu’il y a peu, ce dernier module n’\u00e9tait pas compatible OAuth<\/em>. La mise \u00e0 jour vers OAuth<\/em> ayant \u00e9t\u00e9 faite r\u00e9cemment, la version utilisant OAuth<\/em> n’est pas encore dans les d\u00e9p\u00f4ts. Il va donc falloir l’installer manuellement \u00e0 partir des sources et penser \u00e0 installer dans la foul\u00e9e ses d\u00e9pendances.<\/p>\n

Installation de python-twitter<\/h3>\n

Pour fonctionner, python-twitter<\/em> a besoin des paquets suivants: python-simplejson<\/em> et python-httplib2<\/em> qu’il suffit d’installer de la mani\u00e8re habituelle puisque ces paquets sont dans les d\u00e9p\u00f4ts:<\/p>\n

\r\n$ sudo aptitude install python-simplejson python-httplib2\r\n<\/pre>\n
Il faut aussi installer python-oauth2<\/em> qui est le module permettant d’utiliser ce m\u00e9canisme d’authentification et sur lequel repose python-twitter<\/em>. Ce module n’est malheureusement pas disponible dans le d\u00e9p\u00f4ts mais il existe n\u00e9anmoins un ppa<\/em> offrant la version voulue:<\/p>\n
\r\n$ sudo add-apt-repository ppa:chris-lea\/python-oauth2\r\n$ sudo aptitude update\r\n$ sudo aptitude install python-oauth2\r\n<\/pre>\n
Python-twitter<\/em> lui-m\u00eame est \u00e0 t\u00e9l\u00e9charger sur le site http:\/\/code.google.com\/p\/python-twitter\/<\/a>.
\nLa derni\u00e8re version est la 0.8.1. <\/p>\n
D\u00e9compressez et d\u00e9sarchivez le fichier. Rendez-vous dans le r\u00e9pertoire d\u00e9sarchiv\u00e9 puis tapez les commandes suivantes pour installer python-twitter<\/em>:<\/p>\n
\r\n$ python setup.py build\r\n$ sudo python setup.py install\r\n<\/pre>\n
Vous avez maintenant tous les outils n\u00e9cessaires pour utiliser Twitter depuis une application en python.<\/p>\n
Enregistrer l’application sur le site de twitter<\/h3>\n
Une des obligations impos\u00e9es par Twitter est d’enregistrer son application. Pour cela, vous devez poss\u00e9der un compte Twitter et vous rendre \u00e0 cette adresse: http:\/\/twitter.com\/oauth_clients<\/a>. Remplissez-y le formulaire en faisant attention de bien mettre Client<\/em> dans le champ Application Type<\/em> et mettre le Default Access Type<\/em> en read\/write<\/em> si vous d\u00e9sirez pouvoir envoyer des tweets depuis votre application. En retour, Twitter vous donnera les renseignements suivants qui vous seront n\u00e9cessaires pour la suite:<\/p>\n
\r\nAPI key\r\nZst*******************\r\n\r\nConsumer key\r\nZst*******************\r\n\r\nConsumer secret\r\nmiX**************************************\r\n\r\nRequest token URL\r\nhttps:\/\/api.twitter.com\/oauth\/request_token\r\n\r\nAccess token URL\r\nhttps:\/\/api.twitter.com\/oauth\/access_token\r\n\r\nAuthorize URL\r\nhttps:\/\/api.twitter.com\/oauth\/authorize\r\n<\/pre>\n
Obtenir les autorisations n\u00e9cessaires<\/h3>\n
La premi\u00e8re fois que l’application tente de se connecter \u00e0 un compte Twitter, il faut pr\u00e9alablement  r\u00e9clamer un code PIN \u00e0 l’adresse Request Token URL<\/em> re\u00e7ue \u00e0 l’\u00e9tape pr\u00e9c\u00e9dente puis avec ce code PIN visiter la page Authorize URL<\/em>. Ce n’est qu’\u00e0 ce moment qu’on peut r\u00e9clamer la Token Key<\/em> et le Token Secret<\/em> via l’Access Token URL<\/em> indispensable pour acc\u00e9der au compte Twitter. <\/p>\n
Pour cela, j’ai \u00e9crit un petit script en python tr\u00e8s largement inspir\u00e9 de celui trouvable \u00e0 cette adresse:
\nhttp:\/\/code.google.com\/p\/python-twitter\/source\/browse\/get_access_token.py<\/a><\/p>\n
Ce script se connecte \u00e0 l’adresse Request token URL<\/em> re\u00e7ue lors de l’enregistrement de l’application sur le site de Twitter et, en donnant la Consumer key<\/em> et le Consumer Secret<\/em>, on obtient le Request Token Key<\/em> et le Request Token Secret<\/em>. Ces deux tokens<\/em> serviront \u00e0 cr\u00e9er une URL o\u00f9 vous devrez vous rendre pour obtenir un code PIN.
\nEnfin, ce code PIN, une fois introduit dans le script, vous donnera l’Access Token Key<\/em> et l’Access Token Secret<\/em> que votre application doit utiliser pour acc\u00e9der au compte Twitter.
\nOuf! Qui a dit que le m\u00e9canisme d’authentification OAuth \u00e9tait compliqu\u00e9 ?<\/p>\n
\r\nimport<\/span> os\r\nimport<\/span> sys\r\nimport<\/span> urlparse\r\nimport<\/span> oauth\r\n\r\n# Clef et Secret obtenus lors de l'enregistrement de l'application\r\n<\/span>consumer_key = \"Zs*********************\"<\/span>\r\nconsumer_secret = \"miX*************************************\"<\/span>\r\n\r\noauth_consumer = oauth2.Consumer(key=consumer_key, secret=consumer_secret)\r\noauth_client = oauth2.Client(oauth_consumer)\r\n\r\nresp, content = oauth_client.request(\"https:\/\/api.twitter.com\/oauth\/request_token\"<\/span>, 'POST'<\/span>)\r\nif<\/span> resp['status'<\/span>] != '200'<\/span>:\r\n  print<\/span> 'Invalid response from Twitter requesting temp token: %s'<\/span> % resp['status'<\/span>]\r\nelse<\/span>:\r\n  request_token = dict(urlparse.parse_qsl(content))\r\n\r\n  print<\/span> 'Please visit'<\/span>\r\n  print<\/span> '%s?oauth_token=%s'<\/span> % (\"https:\/\/api.twitter.com\/oauth\/authorize\"<\/span>, request_token['oauth_token'<\/span>])\r\n\r\n  # A ce stade, vous devez visiter le site \u00e0 l'adresse indiqu\u00e9e pour recevoir le code PIN\r\n<\/span>  # n\u00e9cessaire au stade suivant.   \r\n<\/span>  pincode = raw_input('Pincode? '<\/span>)\r\n  token = oauth.Token(request_token['oauth_token'<\/span>], request_token['oauth_token_secret'<\/span>])\r\n  token.set_verifier(pincode)\r\n  \r\n  oauth_client  = oauth.Client(oauth_consumer, token)\r\n  resp, content = oauth_client.request('https:\/\/api.twitter.com\/oauth\/access_token'<\/span>, method='POST'<\/span>, body='oauth_verifier=%s'<\/span> % pincode)\r\n  access_token  = dict(urlparse.parse_qsl(content))\r\n \r\n  # Avec le code pin que vous avez introduit, Twitter vous donne un Access Token Key et\r\n<\/span>  # un Access Token Secret qui devront \u00eatre utiliser dans python-twitter. \r\n<\/span>  if<\/span> resp['status'<\/span>] != '200'<\/span>:\r\n    print<\/span> 'The request for a Token did not succeed: %s'<\/span> % resp['status'<\/span>]\r\n    print<\/span> access_token\r\n  else<\/span>:\r\n    print<\/span> 'Your Twitter Access Token key: %s'<\/span> % access_token['oauth_token'<\/span>]\r\n    print<\/span> '          Access Token secret: %s'<\/span> % access_token['oauth_token_secret'<\/span>]\r\n<\/pre>\n
Voici ce qui doit appara\u00eetre dans le terminal au lancement du script:<\/p>\n
\r\nPlease visit\r\nhttps:\/\/api.twitter.com\/oauth\/authorize?oauth_token=fQb*************************************\r\n\r\nPincode? 0595314\r\nYour Twitter Access Token key: 24*******-0gd**************************************\r\n          Access Token secret: 1uX*********************************************\r\n<\/pre>\n
Envoyer un message sur Twitter<\/h3>\n
Maintenant qu’on poss\u00e8de toutes les autorisations n\u00e9cessaires, on peut tweeter un message en utilisant python-twitter<\/em>. Le code, ci-dessous, utilise la Consumer Key<\/em>, le Consumer Secret<\/em>, l’Access Token Key<\/em> et l’Access Token Secret<\/em> pour se connecter \u00e0 Twitter via la classe Api<\/em> du module. On v\u00e9rifie, avec VerifyCredentials()<\/em> que l’on dispose bien des droits indispensables et ensuite on envoie notre tweet sur le compte avec PostUpdate()<\/em>.<\/p>\n
\r\nimport<\/span> twitter\r\n\r\nconsumer_key = \"Zst*******************\"<\/span>\r\nconsumer_secret = \"miX***************************************\"<\/span>\r\naccess_token_key = \"241******-0gd*************************************\"<\/span>\r\naccess_token_secret = \"1uX**************************************\"<\/span>\r\n\r\napi = twitter.Api(consumer_key, consumer_secret, access_token_key, access_token_secret)\r\nresp = api.VerifyCredentials()\r\nif<\/span> resp == None:\r\n  print<\/span> 'Error verifying credentials'<\/span>\r\nelse<\/span>:\r\n  resp = api.PostUpdate('My first twitter message using python'<\/span>)\r\n<\/pre>\n
La classe Api<\/em> du module python-twitter<\/em> permet bien s\u00fbr de faire bien plus que simplement envoyer un simple tweet. Vous pouvez lire la timeline du compte, g\u00e9rer vos abonnements et vos abonn\u00e9s, cr\u00e9er des listes etc… Pour connaitre toutes les possibilit\u00e9s, tapez:<\/p>\n
\r\n$ pydoc twitter.Api\r\n<\/pre>\n
pydoc<\/em> affichera, \u00e0 l’instar des pages de man<\/em>, toutes les fonctions et la doc relative \u00e0 la classe Api<\/em> de python-twitter<\/em>.<\/p>\n
R\u00e9f\u00e9rences<\/h3>\n
http:\/\/code.google.com\/p\/python-twitter\/<\/a>
\nhttp:\/\/dev.twitter.com\/doc<\/a>
\nhttp:\/\/code.google.com\/p\/python-twitter\/source\/browse\/get_access_token.py<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Il est assez facile de cr\u00e9er un petit script ou d’inclure dans une application la possibilit\u00e9 d’envoyer un message sur Twitter m\u00eame si depuis quelques mois Twitter impose un syst\u00e8me d’authentification plus compliqu\u00e9 que la simple identification par identificateur\/mot-de-passe utilis\u00e9e pr\u00e9c\u00e9demment. OAuth est un syst\u00e8me d’identification qui repose, pour sch\u00e9matiser, sur un syst\u00e8me de clef […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[15,5],"tags":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.leunen.com\/linux\/wp-json\/wp\/v2\/posts\/1038"}],"collection":[{"href":"https:\/\/www.leunen.com\/linux\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.leunen.com\/linux\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.leunen.com\/linux\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.leunen.com\/linux\/wp-json\/wp\/v2\/comments?post=1038"}],"version-history":[{"count":4,"href":"https:\/\/www.leunen.com\/linux\/wp-json\/wp\/v2\/posts\/1038\/revisions"}],"predecessor-version":[{"id":1042,"href":"https:\/\/www.leunen.com\/linux\/wp-json\/wp\/v2\/posts\/1038\/revisions\/1042"}],"wp:attachment":[{"href":"https:\/\/www.leunen.com\/linux\/wp-json\/wp\/v2\/media?parent=1038"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.leunen.com\/linux\/wp-json\/wp\/v2\/categories?post=1038"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.leunen.com\/linux\/wp-json\/wp\/v2\/tags?post=1038"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}