scromega blog http://scromega.net/feed/entries.xml Blog personal de Sergio (aka scromega) Accediendo a la API cerrada de Tuenti http://scromega.net/7-accediendo-a-la-api-cerrada-de-tuenti.html Fri, 05 Mar 2010 00:00:58 +0100 http://scromega.net/7-accediendo-a-la-api-cerrada-de-tuenti.html Nota: Tenía escrita esta entrada en borradores antes de que Tuenti lanzara su API de forma cerrada y orientada a empresas que adquieran una licencia, tal y como se puede [url=http://barrapunto.com/articles/10/03/04/1514213.shtml]leer hoy en Barrapunto[/url].

Que no me guste Tuenti no significa que no me guste trastear con las API que ofrecen los distintos servicios web. Pero Tuenti, a día de hoy (más de cuatro años después de su lanzamiento), sigue sin contar con una API pública que permita a los programadores desarrollar aplicaciones para la red social. Supongo que son los intereses económicos los que fuerzan a que (casi) todo el tráfico pase por la web, y, por tanto, aparezcan los anuncios y eventos patrocinados que financian el chiringuito. Como digo, no hay disponible una API pública, pero sí cuentan con una privada que brinda el servicio a la aplicación de Tuenti para el iPhone lanzada recientemente.

Hace un tiempo, [url=http://twitter.com/adrinavarro]@adrinavarro[/url] mostró a un pequeño grupo de conocidos un [url=http://adrian.navarro.at/papers/apituenti.html]paper[/url]. En dicho texto se explicaba muy por encima el modo de funcionamiento (obtenido mediante pruebas) de la citada API privada, pero con el inconveniente de que no se conocía cómo se enviaba la contraseña del usuario a la hora del login. Por tanto, nada se podía hacer con la API.

Por aburrimiento, recordé el texto y me puse con ello (al igual que más gente) hasta conseguir poder usar la API. En cuanto al inconveniente del login, no fue un gran problema, ya que me dio por probar un método que conocía de antes (es lo que tiene haber trasteado anteriormente con la web :D). Lo que sí me supuso un problema fue el tener que jugar a adivinar (literalmente) los nombre de los métodos al no disponer de un iPhone con el que realizar pruebas.

De todo esto ha salido una class en PHP (para variar) que programé para realizar pruebas. Dicha class permite loguearse en Tuenti a través de la API y hacer uso de todos los métodos conocidos de la misma. Con dichos métodos se puede cambiar el mensaje de estado, obtener los perfiles de amigos, obtener fotos de los álbumes, etc.

Por comodidad he subido [url=http://github.com/scromega/tuentiAPI]la class a GitHub[/url] junto con una lista de los métodos disponibles. En dicha lista sólo están los nombres de los métodos, más que descriptivos. Tampoco es plan de documentar la API haciendo el trabajo de una empresa con la que no guardo ninguna relacion, como es Tuenti.]]> tOAuth: la API de Twitter con OAuth y PHP http://scromega.net/6-toauth-la-api-de-twitter-con-oauth-y-php.html Fri, 19 Feb 2010 23:29:12 +0100 http://scromega.net/6-toauth-la-api-de-twitter-con-oauth-y-php.html
En la documentación oficial de la API hay un código de ejemplo alojado en GitHub de cómo usar OAuth con PHP. Este ejemplo no me gustaba y me parecía lioso, por eso me puse a ver cómo funcionaba hasta conseguir crear un clon más sencillo. El resultado, tOAuth, una class en PHP que permite usar de manera simple la API de Twitter con OAuth.

Podéis encontrar el código de la class junto con un ejemplo de uso en el repositorio [url=http://github.com/scromega/tOAuth]tOAuth[/url] de mi cuenta de GitHub. El ejemplo creo que es bastante explícito por sí solo, pero de todas formas a continuación procedo a explicarlo.
[[CORTAR]]
Registro:
Para hacer uso de OAuth en nuestras aplicaciones, deberemos tenerlas registradas como tales en Twitter. Esto se logra desde la página [url]http://twitter.com/oauth_clients/[/url] en la que tenemos un formulario para hacer esto y donde podremos administrar todas las aplicaciones que registremos. En dicho formulario tendremos que rellenar varios campos, entre ellos:

  • Application Type: Evidentemente tendremos que marcar "Browser"

  • Callback URL: La URL a la que Twitter redirigirá a los usuarios una vez autentificados. Por ejemplo: http://dominio.com/toauth

  • Default Access type: Marcamos "Read & Write" para que nuestra aplicación sea capaz de enviar datos (por ejemplo, para actualizar el timeline del usuario)

  • Use Twitter for login: Marcamos "Yes, use Twitter for login"


Una vez registrada la aplicación, se nos asignarán dos keys fundamentales para el uso de OAuth. En el ejemplo, estas dos keys son definidas como constantes para su posterior uso:



<?php

define('CONSUMER_KEY', 'xxxxxxxxxxxxxxxxxxxxx');
define('CONSUMER_SECRET', 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');


Todo usuario que quiera hacer uso de nuestra aplicación tendrá que autentificarse. Este proceso consta de dos partes. Lo primero será obtener el link de Twitter al que tendrá que entrar el usuario para autentificarse:


<?php

$connection = new tOAuth(CONSUMER_KEY, CONSUMER_SECRET);
$a = $connection->authenticate(true);

Esto nos devolverá un array con dos token que deberemos almacenar de forma temporal (por ejemplo en una sesión) y el link mencionado anteriormente.

Una vez que el usuario vuelva a nuestra página tendremos que hacer una nueva petición enviando los token de la anterior ($_SESSION['toauth_rt'] y $_SESSION['toauth_rts'] en el ejemplo):


<?php

$connection = new tOAuth(CONSUMER_KEY, CONSUMER_SECRET, $_SESSION['toauth_rt'], $_SESSION['toauth_rts']);
$a = $connection->authenticate(false);

Nuevamente nos devolverá un array, salvo que en este caso contendrá sólo dos token que son los que usaremos en las peticiones a la API como si del usuario/contraseña se tratara. Si queremos podemos guardarlo de forma permanente (por ejemplo, en una base de datos) para usos futuros.

Peticiones:
Para realizar peticiones (ya sean GET o POST) a la API lo primero será crear una nueva instancia de la class pasándole los token del usuario que obtuvimos en la autentificación ($_SESSION['toauth_at'] y $_SESSION['toauth_ats'] en el ejemplo):


<?php
$connection = new tOAuth(CONSUMER_KEY, CONSUMER_SECRET, $_SESSION['toauth_at'], $_SESSION['toauth_ats']);

Después ya podremos hacer las [url=http://apiwiki.twitter.com/Twitter-API-Documentation]peticiones[/url] que necesitemos a la API. Ejemplos:


<?php

# GET Usage: array get ( string $method [, array $args ] )
# POST Usage: array post ( string $method , array $args )

$r = $connection->get('account/verify_credentials');

$r = $connection->post('statuses/update', array('status'=>'Hello World'));


Y esto es todo, espero que os sea de utilidad tanto como a mí. Si queréis estar al tanto de cambios y actualizaciones, podéis suscribiros al repositorio en GitHub. Para cualquier duda, sugerencia, crítica o lo que sea, ya sabéis, dejad un comentario :)]]> Mini Entrada: (in)necesidad http://scromega.net/5-in-necesidad.html Sat, 05 Dec 2009 02:21:58 +0100 http://scromega.net/5-in-necesidad.html - La que tenga él es lo de menos, que necesidad tienes tú de escucharlo en todo caso :P

Mini entrada patrocinada por el juego "Hotel Dusk: Room 215" y por [url=http://twitter.com/Juendy_/status/6354371711]@Juendy_[/url]]]> Spotify: Error 110 http://scromega.net/4-spotify-error-110.html Sun, 06 Sep 2009 16:50:10 +0200 http://scromega.net/4-spotify-error-110.html
Al principio de dejar de funcionar, el programa se quedaba en la pantalla de "Iniciando sesión..." y parecía como si no tuviera conexión con Internet, por lo que pensé que sería algo de Wine.

Hace unos días, me dio por volver a probarlo y ya al menos el programa mostraba un mensaje de error como el de la imagen siguiente, aunque no fui capaz de solucionar nada.

[center][url=http://www.flickr.com/photos/scromega/3893144780/][img]http://scromeganet.appspot.com/scromega.net/upload/spotify.png[/img][/url][/center]

Hoy necesitaba música desesperadamente, por lo que me dio por volver a intentarlo y me fijé que el mensaje daba un código de error (110). Hice una búsqueda por Google y encontré un mensaje en la comunidad de soporte de Spotify. El mensaje es de alguien que tuvo el mismo problema y explica la solución, tan sencilla como desmarcar la casilla "Recuérdame" y volver a introducir la contraseña.

La gracia del asunto es que yo ya había probado con otra cuenta de usuario e incluso reinstalé el programa, aunque todo eso fue cuando sólo salía lo de "Iniciando sesión..." (antes de que saliera el mensaje de error).

Fuente | [url=http://getsatisfaction.com/spotify/topics/error_110_also_without_my_firewall]Community-powered support for Spotify[/url]]]>