No artigo anterior explicamos os benefícios de usar uma biblioteca para simplificar as tarefas de comunicação com o API de Twitter em PHP e vimos um primeiro exemplo simples. Agora vamos continuar mostrando outros casos de uso desta biblioteca, que nos servirão bem para ir conhecendo seus métodos e as possibilidades que nos dão.

Mostraremos vários exemplos distintos que nos ajudarão a consumir distintos tipos de informação. Sobre o exemplo do artigo anterior ademais cabe assinalar que não chegamos a nos autenticar no API com nenhum usuário de Twitter, porém muitas das ações que poderemos fazer com o API de Twitter sim requerem o login de um usuário. Sendo assim, se mais demora, vamos aprender a enviar nossos dados de usuário para poder realizar todas as ações possíveis dentro do API.

Autenticar-se no API de Twitter

Ao instanciar o objeto de Twitter Class (a biblioteca comentada no anterior artigo e que continuamos utilizando) podemos passar opcionalmente um nome de usuário e senha de Twitter para acessar ao API.

Enviaremos esses dados de autenticação desta maneira:

$usuario_twitter = new Twitter("meuusuario","minhasenha");

Agora poderemos acessar a todos os métodos da biblioteca de acesso ao API de Twitter, como poderiam ser:

Pedir as 20 últimas participações das pessoas que segue o usuário autenticado, junto com seus próprios posts. Isto é o que se chama de linha do tempo dos amigos. Claro que tem que ter um usuário autenticado para que nos deem os dados dos amigos deste.

$statusAmigoseMeus = $usuario_twitter->getFriendsTimeline();

Pedir as 20 últimas participações do usuário autenticado. Ou seja, pedir só os post do usuário autenticado.

$statusUsuario = $usuario_twitter->getUserTimeline();

Pedir as 20 últimas participações do usuário enviado como parâmetro. Permite enviar o id de um usuário ou o string com o nick de usuário utilizado em Twitter.

$statusUsuario = $usuario_twitter->getUserTimeline("criarwebcom");

Peço os usuários seguidos por outro usuário. Se envio o nome de um usuário me dá os seguidos por esse usuário solicitado, se não se indica nada, me dá os seguidos pelo usuário autenticado.

$usuarios_friends = $usuario_twitter->getFriends("criarwebcom");

Como estes há outros tantos métodos que vocês podem conhecer na própria documentação da biblioteca Twitter Class. Para acabar, vamos ver o código completo de uma página que faz todas estas solicitações e mostra na página o resultado.

<?php
include "twitter.php";
$usuario_twitter = new Twitter("usuario","senha");

//pedir as 20 últimas participações das pessoas que segue o usuário autenticado e seus próprios status
$statusAmigoseMeus = $usuario_twitter->getFriendsTimeline();
echo "<pre>";
print_r($statusAmigosyMios);
echo "</pre>";


//pedir las 20 últimas participacipaciones del usuario autenticado
$statusUsuario = $usuario_twitter->getUserTimeline();
echo "<pre>";
print_r($statusUsuario);
echo "</pre>";


//pedir as 20 últimas participações do usuário enviado como parâmetro
$statusUsuario = $usuario_twitter->getUserTimeline("criarwebcom");
echo "<pre>";
print_r($statusUsuario);
echo "</pre>";

//peço os usuários aos que seguem o usuário que se envie por parâmetro
$usuarios_friends = $usuario_twitter->getFriends("criarwebcom");
echo "<pre>";
print_r($usuarios_friends);
echo "</pre>";

?>

No seguinte artigo mostraremos como enviar mensagens ou post a Twitter com a conta do usuário autenticado, desde o próprio API de Twitter.