Trabajar con la API de Twitter en PHP

Estos días por alguna extraña razón me estoy dedicando a las API’s, y como no podia faltar voy a explicar un uso básico de la API de twitter.

Empezaremos bajando la Class de Twitter

En el primer ejemplo veremos el TimeLine de Twitter, lo primero que tenemos que hacer es crear el objeto:

$tw = new Twitter();

y usaremos la función getPublicTimeLine() para acceder al Timeline

<?php
include_once('twitter.php');

/* Ejemplo 1: TimeLine */
$tw = new Twitter();

$timeline = $tw->getPublicTimeLine();

echo '<pre>';
print_r($timeline);
echo '</pre>';

?>

Como veis nos devuelve un array con lo que ahora sabemos a que claves tenemos que acceder para sacar los datos que nos interesan así que podriamos hacer algo más prolijo así:

include_once('twitter.php');

$tw = new Twitter();

$timeline = $tw->getPublicTimeLine();

foreach ($timeline as $tweet)
{
echo 'User: '.$tweet['user']['name'].'<br/>
Text: '.$tweet['text'].'<br/>
Source: '.$tweet['source'].'<br/>
Date: '.date('d-m-Y', $tweet['created_at']).'<br/><br/>';
}

En el segundo ejemplo aprenderemos a loguear una cuenta en Twitter y acceder al timeline de nuestros amigos, al de un amigo en específico, a nuestro timeline o ver los amigos de alguien.

Ahora al iniciar el objeto tenemos que pasarle dos parámetros (usuario, contraseña)

$tw = new Twitter('user', 'pass');

Usaremos 3 funciones:

– getFriendsTimeline(): nos devuelve el timeline de nuestros amigos
– getUserTimeline(): Sin parámetro nos devuelve nuestro timeline, podemos agregar el nombre de un usuario para recivir su timeline.
– getFriends(‘user’): Nos da la lista de amigos de el user.

<?php
include_once('twitter.php');
/* Ejemplo 2: Auth in Twitter */

$tw = new Twitter('user', 'pass');

$friendtweet = $tw->getFriendsTimeline(); //Timeline de amigos
$mytweet = $tw->getUserTimeline(); //Mi timeline
$dragontweet = $tw->getUserTimeline('DragonJAR'); //El Timeline de dragon
$exactlimonfriends = $tw->getFriends('exactlimon'); //Los amigos de exactlimon.

echo '<pre>';
echo print_r($friendtweet);
echo '</pre>';
?>

EL último ejemplo que trataremos hoy nos enseña como enviar un tweet, además agregaremos un par de comandos para manejar algunoos errores.

Las funciones nuevas a usar son:
– test(): Comprueba que haya conexión con twitter.
– verifyCredentials(): Comprueba que user y pass son correctos.
– updateStatus: Envia el tweet.

<?php
include_once('twitter.php');

/* Ejemplo 3: Enviando mensajes a twitter */
$tw = new Twitter('user', 'pass');

if ($tw->test()) { //comprobamos conexión
if($tw->verifyCredentials()){ //comprobamos user y pass
$tw->updateStatus('menasje de prueba con la API twitter');
echo 'Mensaje enviado';
} else
echo 'Usuario o contraseña incorrectas';
} else {
echo 'No hay conexión con twitter';
}
?>

Como veis no hay mucho que explicar, esta API es muy simple he intuitiva así que os animo a probarla.