Oggi, arrivato al lavoro, ho trovato una brutta sorpresa. Tutti i siti internet che facevano uso delle API di Twitter per restituire il numero di follower, o semplicemente gli ultimi tweet, non funzionavano più. Presto ho scoperto il motivo… Twitter, proprio oggi, ha disattivato definitivamente la versione 1.0 delle proprie API.

Ancor peggio, le nuove API fanno uso di Oauth per l’accesso al flusso di dati json… tecnologia che non amo particolarmente.

Detto questo vediamo un pò come ho implementato un client php per l’accesso alle API 1.1 di Twitter.

Un po di teoria

La motivazione di Twitter a cambiare la modalità di accesso alle proprie API è quella di avere maggior controllo su chi e come le utilizza.

Il meccanismo, a livello concettuale, è piuttosto semplice. Si registra un’applicazione nella sezione developer del sito e con le chiavi generate si va a richiedere un Access Token, chiave d’accesso ( spesso temporanea e comunque variabile ) che permette di consultare i dati, restituiti, in questo caso, in formato json.

Capito come funziona l’Oauth di Twitter è stato sufficiente dare un’occhiata al modello di autenticazione applicazione sulla documentazione ufficiale per riuscire a creare una classe che semplificasse l’accesso alle API.

La soluzione – Twitter API 1.1 Client per WordPress

Passiamo alla pratica! Scaricate il pacchetto Twitter API 1.1 Client for WordPress che ho caricato su github a questo indirizzo e includete il file class-wp-twitter-api.php nel file functions.php del tema o nel codice del plugin WordPress.

Ora create una nuova applicazione di Twitter a questo indirizzo, cliccando sul pulsante “Create a new application”. Compilate tutti i dati e procedete. Scorrendo il pannello “Details” troverete due codici che ci interessano: Consumer key e Consumer secret. Sono quelli che andremo ad inserire nella nostra richiesta alle API. Fatto questo vi lascio ad un paio di esempi che valgono più di mille parole!

Esempio A – Ottenere gli ultimi 5 tweet di un determinato utente

In questo primo esempio andiamo a fare una query alle API di Twitter per ottenere gli ultimi 5 tweet dell’utente micc1983. Per farlo usiamo le impostazioni di default, ovvero statuses/user_timeline e cache a 30 minuti. Per comporre la query usiamo i parametri che potete trovare a questo indirizzo restituendo infine il risultato come oggetto facendone un var_dump (sono sicuro che poi penserete voi a formattarlo).

<?php

// Includo la classe Wp_Twitter_Api
require_once( 'class-wp-twitter-api.php' );

// Creo un'array con i dati generati da https://dev.twitter.com/apps
$credentials = array(
  'consumer_key' => 'xxxxxxxxxxxxxxxx',
  'consumer_secret' => 'xxxxxxxxxxxxxxxx'
);

// Istanzio la mia classe con le credenziali registrate
$twitter_api = new Wp_Twitter_Api( $credentials );

// Registro la query
$query = 'count=5&include_entities=true&include_rts=true&screen_name=micc1983';

// E la eseguo
$result = $twitter_api->query( $query );

// Infine faccio un var_dump del risultato che conterrà gli ultimi 5 tweet del mio account
var_dump( $result );

Esempio B – Ottenere il numero di follower di un dato utente

Il secondo esempio è un po più complesso in quanto, invece di utilizzare statuses/user_timeline, accede ad una risorsa diversa: users/show. Qua potete trovare una lista completa delle risorse cui potete accedere. Inoltre, per comprendere tutte le possibilità, imposteremo la cache a 24 ore invece della mezzora di default.

<?php

// Includo la classe Wp_Twitter_Api
require_once( 'class-wp-twitter-api.php' );

// Creo un'array con i dati generati da https://dev.twitter.com/apps
$credentials = array(
  'consumer_key' => 'xxxxxxxxxxxxxxxx',
  'consumer_secret' => 'xxxxxxxxxxxxxxxx'
);

// Istanzio la mia classe con le credenziali registrate
$twitter_api = new Wp_Twitter_Api( $credentials );

// Registro la query 
$query = 'screen_name=micc1983';

// ed i parametri necessari ad accedere ai dati utente
$args = array(
  'type' => 'users/show',         // Risorsa utilizzata per accedere ai dati utente (default statuses/user_timeline)
  'cache' => ( 24 * 60 * 60 )     // Imposto la cache a 24 ore (default 30 minuti)
);

// Ora eseguo la query
$result = $twitter_api->query( $query, $args );

// E faccio l'echo del risultato
echo $result->followers_count;

Se vi trovate in difficoltà a costruire la query date un’occhiata alla console di Twitter oppure provate a chiedere nei commenti 🙂