Hace ya unos días que quería probar un poco de estudiar el funcionamiento de las apis.
Ya tenia alguna cosilla echa, pero nunca había profundizado en el tema, y así para empezar,  me decidí por las api de flickr, ya que el tema de las fotos me interesa para futuras aplicaciones.
Primero de todo hay que decir, que están muy bien documentadas, un punto a favor para los novatillos como yo. Aparte de encontrar mucha info, todo esta muy bien redactado y las clases que utilizan son bastante intuitivas.
Experimento 1: creación de un buscador de fotos

Para empezar, quería hacer algo simple, como conseguir mostrar fotos a través de una búsqueda.
Lo primero que debemos hacer, es registrarnos como desarrolladores (y como usuarios de yahoo si no lo estamos) y que nos den una clave de desarrollo (sin esto no podremos hacer ná de ná )
Luego, seria bueno leer un poco el funcionamiento de la api, que sus manuales están súper bien!
Manos a la obra:
Para empezar, encontré una clase ya echa para interactuar mas fácilmente con el api de flickr. Esta clase es phpflickr implementa métodos que procesan el XML de respuesta de Flickr y lo transforman a arreglos de PHP para que puedas desarrollar la aplicación de forma fácil e intuitiva.
Luego, modificando un poco el código, implemente lo que seria una búsqueda normal por tags:

PLAIN TEXT
PHP:
  1. require_once("phpFlickr.php"); //Incluyendo el API de Flickr
  2. $f = new phpFlickr("clave_api"); //Key de Api, conseguir en: http://www.flickr.com/services/api/keys/
  3. //  $nsid = "numero@N11"; //Para buscar por Usuario concreto.  NSID Usuario, conseguir en: http://idgettr.com/
  4.  
  5. $photos = $f->photos_search(array("tags"=>$tags)); //Solo realizamos una busqueda por tag
  6.  
  7. if (is_array($photos['photo']))
  8.  
  9. {
  10. foreach ($photos['photo'] as $photo)
  11. {
  12.  
  13. $salida .= "<a href='".$url.$photo['id']."'><img alt='".$photo['title']."' title='".$photo['title']."' "."src='".$f->buildPhotoURL($photo, "square")."' /></a>";
  14.  
  15. }
  16.  
  17. }

Como veis este es un ejemplo muy básico, de búsqueda por tag.
Luego si miramos toda la clase flickr.photo.search, podemos ver que los parámetros a buscar son muchos, como privacidad, por grupo, por tiempo, por usuario (nsid), etc...

Aquí podéis ver un poco mi experimento. Podreis ver que he utilizado diferentes tipos de búsquedas y algunos criterios, como son Privacidad o tipo de medio (foto o video).