La problématique :

Aujourd'hui nous allons aborder l'API mise en place par tubmblr. Mon age canonique ne me permet malheursement pas définir ce qu'est tumblr (en clair je vois pas trop le but ultime de ce site) mais je sais qu'il regorgs d'API. Comme d'habitube nous verrons ici les principales mais la documentation vous permettra de voir les autre fonctionnalités de l'API ue je n'aborderai pas ici. Comme à mon habitude, les commandes en POST, je n'arrive pas à les traiter...

Le service interrogé : TUMBLR

Une fois votre compte créé, demandez une clef API afin de pouvoir suivre ce tutoriel. A l'heure où j'écris ces lignes, il suffit de se connecter et de se rendre ici : https://www.tumblr.com/oauth/apps afin de demander la création de la clef API pour vous authentifier. C'est fait ? Allons y !

La documentation de cette API est relativement claire je trouve et se retrouve sur https://www.tumblr.com/docs/en/api/v2.
Ne possédant absolument rien sur mon tumblr, nous allons travailler sur deux compte tumblr : l'une d'une cyber dominatrice très connue dans le milieu, nous l'utiliserons pour récupérer des infos, et l'autre, mon tumblr à moi pour poster les infos.
Et en plus c'est une belle femme...

Explications

Le service Tumblr demande une authentification, il passe évidemment par OAuth, au lieu de réinventer la roue. Le principe est simple (pour tumblr du moins) : il suffit de passer la clef API dans l'URL. On teste ?

Recherchons des informations (méta données) sur le blog de Maitresse HARLEY (en bleu, c'est le nom du blog sur lequel on travaille) :

https://api.tumblr.com/v2/blog/mistressharley/info?api_key=VOTRE API_KEY

Recherchons ert récupérons l'avatar du blog, en spécifiant la taille :

api.tumblr.com/v2/blog/mistressharley/avatar
On peut aussi spécifier la taille de l'avatar "carré" que l'on souhaite : api.tumblr.com/v2/blog/mistressharley/avatar/[size] où [size] est un nombre parmi 16, 24, 30, 40, 48, 64, 96, 128, 512.

Dans cette requete, la clef API a l'air facultative.

Récupérer les likes de son blog à soi (pas d'un autre, ca marche pas)

http://api.tumblr.com/v2/blog/teenagepoetrypanda/likes?api_key=VOTRE API_KEY

Le réponse retournée contient ainsi deux valeurs :

• liked_posts : les posts likés

• liked_count : le nombre de posts likés

Récupérer les informations d'un blog :

https://api.tumblr.com/v2/blog/mistressharley.tumblr.com/info?api_key=VOTRE API_KEY
Il ne reste plus qu'a extraire ce qui vous interesse

Complément d'informations : https://www.tumblr.com/docs/en/api/v2