La guía definitiva para decodificar la API de Flickr

Spanish (Español) translation by Luis Chiabrera (you can also view the original English article)

Flickr, siendo el sitio más grande de administración y uso compartido de fotos en el mundo, tiene una API impresionante para permitir a los desarrolladores acceder y manipular casi todos sus datos. Veamos cómo trabajar con la API: en el nivel más bajo posible.

Una Palabra del Autor

En esta era de la Web 2.0, las aplicaciones web que tienen una API intuitiva y fácil de usar tienen una clara ventaja, ya que les permite a los desarrolladores explotar y construir para la plataforma y así capturar a más usuarios. A medida que avanzamos hacia la web social y los mashups, una buena API ya no es una buena adición: es francamente necesaria. Y recuerda que demasiada abstracción nunca es algo bueno. Si bien hay una serie de kits de API para simplificar el trabajo con la API en cuestión, ¿no sería genial saber qué está pasando realmente bajo el capó? ¿No sería emocionante deconstruir el vudú real entre el kit y la API? Sí, eso creo! En esta nueva serie, veremos las API de algunos de los servicios más populares que existen. Hoy, echamos un vistazo a la API de Flickr.

La Secuencia de Eventos

El tango entre el desarrollador y la API comienza y culmina en una serie de pasos bien definidos. Explicaré cada paso a medida que avanzamos.

Decidir el Tipo de Aplicación

En primer lugar, tenemos que decidir sobre el tipo de aplicación que vamos a construir. Las aplicaciones de escritorio tienen que usar el modelo de escritorio, mientras que una aplicación web puede usar cualquiera de los modelos. El modelo móvil está más allá del alcance de este artículo.

Para este artículo, elegí ir con el modelo de escritorio, ya que el modelo web requiere que se realicen todas las pruebas en el dominio en el que se implementará la aplicación. Esto podría no ser necesariamente factible para muchas personas. Elegimos el modelo de escritorio ya que carece de esta restricción.

Obtención de una Clave API

El siguiente paso es obtener una clave de aplicación. Flickr utiliza esta clave de aplicación para controlar nuestro uso y otras estadísticas. Dirígete aquí y solicita tu propia clave API.

Dado que nuestro uso de esta clave API particular es puramente educativo, elegimos obtener una clave no comercial.

Complete todos los detalles que requiere el formulario con especial atención a la descripción del proyecto. Los desarrolladores de Flickr en realidad leen esta descripción si su aplicación se comporta mal de alguna manera para asegurarse de que sea legítima. Así que pasa ese minuto extra describiendo tu obra maestra.

Un registro exitoso le proporciona esta página. Anote la clave de la API y el secreto compartido para su uso posterior.

Conceptos Básicos de la API de Flickr

La API de Flickr proporciona varios métodos que pueden requerir o no autenticación. Cada método toma una serie de argumentos que modifican su comportamiento y carga útil. Las respuestas se pueden recibir en varios formatos, incluidos JSON, XML, SOAP y REST. Todas estas solicitudes se pueden realizar en los puntos finales correspondientes al formato que haya elegido para realizar la solicitud. Por ejemplo, usaremos REST para el resto de este artículo, por lo que nuestro punto final de URL sería http://api.flickr.com/services/rest/.

Extrayendo Datos Públicos

Existen varios métodos que extraen datos públicos y, por lo tanto, no requieren autenticación de ningún tipo. Solo necesitamos la clave de API que obtuvimos anteriormente junto con los argumentos necesarios del método en cuestión. Veamos un ejemplo.

El método getPublicGroups es un ejemplo de un método que no requiere autenticación y que extrae datos públicos. Pasamos la identificación de usuario del usuario y nuestra clave de API y la API responde en el formato que solicitó con una lista de grupos de los que forma parte el usuario.

Enviaremos una solicitud a esta URL.

1	http://api.flickr.com/services/rest/?method=flickr.people.getPublicPhotos&api_key=your_api_key&user_id=user_id_x

Reemplace your_api_key con la clave que obtuvimos anteriormente y user_id_x con un NSID válido. Como me gusta que mis respuestas estén en JSON, puedo agregar otro parámetro pidiéndole a la API que responda con una carga JSON.

1	http://api.flickr.com/services/rest/?method=flickr.people.getPublicPhotos&api_key=your_api_key&user_id=user_id_x&format=json

La API enviará una respuesta así:

1	jsonFlickrApi({"photos":{"page":1, "pages":1, "perpage":100, "total":"2",
2	"photo":[{"id":"3728895285", "owner":"40318902@N02", "secret":"df6dfee053", "server":"3466",
3	"farm":4, "title":"opac", "ispublic":1, "isfriend":0, "isfamily":0},
4	{"id":"3729689790", "owner":"40318902@N02", "secret":"ea9c38a675",
5	"server":"2531", "farm":3, "title":"scale", "ispublic":1, "isfriend":0, "isfamily":0},]},
6	"stat":"ok"})

Formateado correctamente, se verá así.

1	jsonFlickrApi(
2	{"photos": {
3	"page": 1,
4	"pages": 1,
5	"perpage": 100,
6	"total": "2",
7	"photo": [
8	{
9	"id": "3729689790",
10	"owner": "40318902@N02",
11	"secret": "ea9c38a675",
12	"server": "3466",
13	"farm": 4,
14	"title": "opac",
15	"ispublic": 1,
16	"isfriend": 0,
17	"isfamily": 0
18	},
19	{
20	"id": "3729689845",
21	"owner": "40318902@N02",
22	"secret": "df6dfee053",
23	"server": "2531",
24	"farm": 3,
25	"title": "scale",
26	"ispublic": 1,
27	"isfriend": 0,
28	"isfamily": 0
29	}
30	]
31	},
32	"stat": "ok"
33	})

Extrayendo Datos Privados

Esta es probablemente la razón por la que desea aprender a trabajar con la API de Flickr, por lo que revisaremos cada paso lentamente, ya que esta parte tiende a confundir a las personas.

Firmando

Para obtener datos privados, cada método necesita autenticación y para que la autenticación funcione, se debe firmar cada una de nuestras llamadas. La firma funciona así:

Haga una lista ordenada alfabéticamente de los argumentos

Por ejemplo, en el ejemplo anterior nuestra lista se vería así:

api_key: xxx
formato: json
user_id: yyy

Crea la cadena de firma

La cadena de firma se crea tomando el secreto API que obtuvimos anteriormente y luego agregando la lista de argumentos. Por ejemplo, nuestra cadena de firma se vería así:

1	0123456789api_keyxxxformatjsonuseridyyy

Firmando nuestra llamada

El último paso es la firma real. Flickr espera que tomemos el hash MD5 de nuestra cadena de firma y lo agreguemos a nuestra llamada al método original como un parámetro con nombre.

Entonces, cualquier llamada autenticada tiene este formato general

1	http://api.flickr.com/services/rest/?method=ourmethod&api_key=apikey&api_sig=hashedvalue

Obteniendo un frob

Ahora con el cierre de sesión, ahora podemos pasar a la autenticación real. Flickr utiliza un sistema similar a OAuth para la autorización, lo que significa que un usuario que quiera usar nuestra aplicación no necesita divulgar sus credenciales de usuario. Los usuarios son transportados al sitio web de Flickr, donde se le pregunta si desea permitir que nuestra aplicación acceda a los datos del usuario.

Aquí es donde entra un frob. Para crear el enlace de inicio de sesión que lleva al usuario a una página de autorización en Flickr, necesitamos una forma de identificar una sesión de inicio de sesión específica.

Para obtener un frob para identificar la sesión, necesitamos llamar al flickr.auth.getFrob pasando nuestra clave de API como argumento con nombre. Nuestra URL se vería así:

1	http://api.flickr.com/services/rest/?method=flickr.auth.getFrob&api_key=apikey&api_sig=hashedvalue

Una respuesta JSON se ve así:

frobcallback(
	{"frob":{
    	"_content": "xxx"
        }, 
     "stat":"ok"
     })

Construyendo la URL de inicio de sesión

Después de obtener con éxito un frob, ahora podemos trabajar en la creación de la URL que permite al usuario autorizar nuestra aplicación. La URL de inicio de sesión tiene este formato general:

1	http://flickr.com/services/auth/?api_key=apikey&api_sig=apisig&perms=perms&frob=frob

Reemplace el valor de api_key con el que habíamos obtenido anteriormente, el valor de api_sig con un hash MD5 de nuestra cadena de firma y el valor de frob con el valor de frob devuelto por la API. El parámetro perms define el nivel deseado de acceso a la cuenta y tiene valores válidos de lectura, escritura y eliminación. Cada acceso incluye los derechos de todos sus predecesores.

Una URL de inicio de sesión válida toma esta forma:

1
2	http://flickr.com/services/auth/?api_key=63b08e2efcc22de9900163f4d761fdbc&api_sig=663369798c695dbe2fd7e2af7576dd2b&perms=delete&frob=72157621742082858-8e995a1104e28114-870912

Las páginas de autorización se ven así:

Primero, Flickr se asegura de que el usuario no haya sido engañado para autorizar la aplicación.

A continuación, se asegura de que el usuario conozca el nivel de autorización que está otorgando a la aplicación.

Autorización exitosa!

Obteniendo el token de autenticación

Una vez que el usuario ha autorizado nuestra aplicación, podemos continuar. El último paso en este proceso es obtener un auth_token. Un token de autenticación vincula una clave API específica a un ID de usuario específico, es decir, un token de autenticación se puede usar para manipular solo los datos de un usuario específico mientras se usa una clave API específica. Es necesario un token de autenticación para todas y cada una de las llamadas a métodos API que requieren autenticación.

Obtener un token de autenticación es tan simple como llamar al método flickr.auth.getToken pasando la clave api, frob y la firma api como parámetros con nombre. La URL se vería así:

1	http://flickr.com/services/auth/?api_key=apikey&api_sig=apisig&frob=frob

Una solicitud exitosa nos proporciona un token de autenticación que se puede usar indefinidamente para acceder a los datos de un usuario específico utilizando una clave API específica.

Haciendo la llamada

Ahora que se han cumplido todos los requisitos previos, podemos recuperar los datos según sea necesario. Recuerde, cada una de sus llamadas autenticadas debe estar firmada, por lo que cada llamada debe enviar api_key, auth_token y api_sig para que la llamada al método funcione.

Como mínimo base, la URL de su solicitud REST debe tener este aspecto. Se pueden agregar otros parámetros específicos del método o parámetros que modifican la carga útil según sea necesario.

1
2	http://flickr.com/services/auth/?api_key=xxx&api_sig=yyy&auth_token=zzz&method=method_name

Al firmar, asegúrese de incluir también los otros argumentos y sus valores. Esta es una causa frecuente de error y dolor de cabeza y se rectifica fácilmente. ¿Incluye parámetros de devolución de llamada en la URL para evitar la restricción de dominio cruzado en los navegadores mientras usa AJAX? ¡Esos también tienen que ir en la cadena de firma!

Reconstruyendo las URL

Echemos un vistazo a una respuesta de ejemplo para un método que devuelve fotos públicas.

1	jsonFlickrApi(
2	{"photos": {
3	"page": 1,
4	"pages": 1,
5	"perpage": 100,
6	"total": "2",
7	"photo": [
8	{
9	"id": "3729689790",
10	"owner": "40318902@N02",
11	"secret": "ea9c38a675",
12	"server": "3466",
13	"farm": 4,
14	"title": "opac",
15	"ispublic": 1,
16	"isfriend": 0,
17	"isfamily": 0
18	},
19	{
20	"id": "3729689845",
21	"owner": "40318902@N02",
22	"secret": "df6dfee053",
23	"server": "2531",
24	"farm": 3,
25	"title": "scale",
26	"ispublic": 1,
27	"isfriend": 0,
28	"isfamily": 0
29	}
30	]
31	},
32	"stat": "ok"
33	})

Todo está bien, pero la respuesta no contiene una URL a la que podríamos vincularnos. En su lugar, tenemos que construir una URL para la imagen en cuestión basada en los datos enviados desde el servidor. Aquí es cómo:

La URL de alguna imagen en Flickr sigue un patrón bien definido. Desbloquee esto y la respuesta comenzará a tener mucho más sentido. Aquí está la URL de una imagen en mi cuenta.

1	http://farm3.static.flickr.com/2531/3729689790_ea9c38a675_b.jpg

La URL está compuesta de varias partes:

Farm ID. 3 en nuestro caso.
Server ID. 2531 aquí.
Foto ID - una forma de identificar de forma única todas y cada una de las fotos alojadas por Flickr. 3729689845 en este caso.
Photo secret - ea9c38a675
Image size - define el tamaño de la imagen que se devolverá. Los valores posibles incluyen o para el original, b para un ancho / alto de 1024, m para 240, t para 100 ys para 75. Cuando no se especifica, el valor predeterminado es un ancho / alto de 500.

En resumen, para construir la fuente de la imagen, el enlace se vería como el que se muestra a continuación si se nos hiciera analizar la respuesta JSON donde los datos son la variable que contiene la respuesta:

1	"http://farm" + data.photos.photo[i].farm + ".static.flickr.com/" + data.photos.photo[i].server + "/"+data.photos.photo[i].id + "_"+data.photos.photo[i].secret + ".jpg

Subiendo a Flickr

Ahora que hemos echado un vistazo a cómo recuperar datos de Flickr usando su API, es hora de echar un vistazo a cómo enviar datos de vuelta.

La API de carga de Flickr es distinta de sus API basadas en REST o SOAP en que no hay puntos finales de URL a los que pueda acceder y recuperar datos. En cambio, los datos deben enviarse a través de una solicitud POST a

1	http://api.flickr.com/services/upload/

Dado que está fuera del alcance de este artículo mostrarle cómo construir una consulta POST desde cero, utilizaremos un elemento de formulario con un valor enctype de multipart / form-data para generar todo el código para nosotros. El uso de este determinado atributo nos permite afirmar que el formulario contiene datos binarios y debe manejarse como tal. Un formulario de muestra se vería así.

1	<form enctype="multipart/form-data" method="post" action="http://api.flickr.com/services/upload/">
2	<input type="file" name="photo"/>
3	<input type="submit" name ="submit" value="Upload"/>
4	</form>

Pero recuerde, aún necesitamos enviar una serie de parámetros al servicio, incluida la clave de API, el token de autenticación y la firma del método. ¿Como hacemos eso? Es solo una cuestión de crear un campo de texto oculto y modificar su valor para reflejar los valores correctos. Al igual que:

<form enctype="multipart/form-data" method="post"  action="http://api.flickr.com/services/upload/">
<input type="file" name="photo"/>
<input type="hidden" name="api_key" value=""/>
<input type="hidden" name="auth_token" value=""/>
<input type="hidden" name="api_sig" value=""/>
<input type="submit" name ="submit" value="Upload"/>
</form>

Recuerde que al generar el hash MD5 de la cadena de firma, debe cargar todos los elementos del formulario, excluyendo el campo de la foto. Esto incluye el valor de los botones de envío, ya que el contenido de todo el formulario se publica en la URL. Para el ejemplo anterior, el hash debería calcularse así:

1	var hash = MD5(secret + "api_key" + apikey + "auth_token" + token + "submitUpload");

No estás completamente limitado a esos argumentos. La API de carga incluye una serie de argumentos que incluyen el título de la foto, su título y descripción. Si lo desea, puede dejar que el usuario ingrese todos esos datos junto con la configuración de privacidad de la misma manera:

<form enctype="multipart/form-data" method="post"  action="http://api.flickr.com/services/upload/">
<input type="file" name="photo"/>
<input type="text" name="title" value=""/>
<input type="text" name="description" value=""/>
<input type="text" name="tags" value=""/>
<input type="text" name="is_public" value="0"/>
<input type="text" name="is_friend" value="1"/>
<input type="text" name="content_type" value="1"/>
<input type="text" name="hidden" value="2"/>
<input type="hidden" name="api_key" value=""/>
<input type="hidden" name="auth_token" value=""/>
<input type="hidden" name="api_sig" value=""/>
<input type="submit" name ="submit" value="Upload"/>
</form>

Métodos de Uso Común

Un artículo sobre cómo trabajar con la API de un servicio estaría claramente incompleto sin una mirada a algunos de los métodos de API más utilizados. Con eso en mente, aquí hay algunos métodos de API que deberían ser muy útiles independientemente de si está creando un mashup o solo está buscando recuperar sus propios datos.

Recuerde, las llamadas autenticadas requieren valores válidos para que los parámetros api_key, api_sig y auth_token funcionen, mientras que las llamadas normales pueden o no requerir parámetros específicos del método. Todas las llamadas requieren que se envíe el parámetro api_key. Por lo tanto, si menciono que la llamada requiere autenticación, el hecho de que la llamada requiera los otros argumentos está implícito. Los argumentos anotados a continuación son opcionales a menos que se mencione lo contrario. Los métodos que devuelven una lista de datos también toman un argumento de página y por página para definir sus homónimos.

He incluido respuestas de cada método para darle una idea sobre los datos que se nos devuelven. He elegido JSON como formato de respuesta, ya que a la mayoría de los desarrolladores con los que trabajo les gusta JSON mejor que XML.

flickr.activity.userPhotos
Devuelve una lista de actividades recientes en fotos que pertenecen al usuario que llama.

Argumentos: timeframe - define el marco temporal en el que buscar actualizaciones.

Autenticación: Si

Respuesta

{
    "items": {
          "item":[
               {
                   "type": "photo",
                   "id": "3728895285",
                   "owner": "40318902@N02",
                   "ownername": "lordtottuu",
                   "secret": "df6dfee053",
                   "server": "3466",
                   "farm": 4,
                   "title": {
                         "_content": "opac"
                        },
                   "commentsold": 1,
                   "commentsnew": 0,
                   "notesold": 0,
                   "notesnew": 0,
                   "views": 0,
                   "faves": 0,
                   "more": 0,
                   "activity": {
                         "event": [
                               {
                                   "type": "comment",
                                   "commentid": "40298554-3728895285-72157621628251433",
                                   "user": "40318902@N02",
                                   "username": "lordtottuu",
                                   "dateadded": "1248131143",
                                   "_content": "Demo image for my upcoming article on Net Tuts"
                               }
                            ]
                        }
                  }
            ],
          "page": 1,
          "pages": 1,
          "perpage": 10,
          "total": 1
      },
     "stat": "ok"
}

flickr.contacts.getList
Devuelve una lista de contactos para el usuario llamante.

Argumentos: filter - Argumento para filtrar la lista. Los valores válidos incluyen amigos, familiares, ambos y ninguno.

Autenticación: Si

Respuesta

{
     "contacts": {
           "page": 1,
           "pages": 1,
           "per_page": 1000,
           "perpage": 1000,
           "total": 2,
           "contact": [
               {
                  "nsid": "7488445@N05",
                  "username": "thegleek",
                  "iconserver": "179",
                  "iconfarm": 1,
                  "ignored": 0,
                  "realname": " Mike Poleski",
                  "friend": "1",
                  "family": "0",
                  "path_alias": null,
                  "location": ""
               }
            ]
         // Rest of the contacts
      },
     "stat": "ok"

flickr.favorites.getList
Devuelve una lista de fotos marcadas como favoritas por un usuario específico.

Argumentos: min_fave_date, max_fav_date: se explica por sí mismo.

Autenticación: Si

Respuesta

1	{
2	"photos": {
3	"page": 1,
4	"pages": 1,
5	"perpage": 100,
6	"total": "3",
7	"photo": [
8	{
9	"id": "2332823355",
10	"owner": "53555705@N00",
11	"secret": "e603be40a2",
12	"server": "2333",
13	"farm": 3,
14	"title": "Xbox 360 still life",
15	"ispublic": 1,
16	"isfriend": 0,
17	"isfamily": 0,
18	"date_faved": "1248134938"
19	}
20	]
21	// Rest of the photos
22	},
23	"stat": "ok"
24	}

flickr.people.getPublicPhotos
Obtenga una lista de fotos públicas para el usuario dado.

Argumentos: nsid [required] - ID del usuario llamante, safe_search - Para bloquear el contenido NSFW.

Autenticación: no

Respuesta

1	{
2	"photos": {
3	"page": 1,
4	"pages": 1,
5	"perpage": 100,
6	"total": "15",
7	"photo": [
8	{
9	"id": "3728895285",
10	"owner": "40318902@N02",
11	"secret": "df6dfee053",
12	"server": "3466",
13	"farm": 4,
14	"title": "opac",
15	"ispublic": 1,
16	"isfriend": 0,
17	"isfamily": 0
18	}
19	]
20	// Rest of the photos
21	},
22	"stat": "ok"
23	}

flickr.groups.getInfo
Para obtener información sobre un grupo en particular.

Argumentos: group_id [required]: el ID del grupo sobre el que busca información.

Autenticación: No

Respuesta

{
    "group": {
           "id": "51035612836@N01",
           "iconserver": "1",
           "iconfarm": 1,
           "name": {
                 "_content": "Flickr API"
           },
           "description": {
                 "_content": string"A Flickr group for Flickr API projects. Driving awareness of the Flickr API, projects that use it and those incredible ideas that programmatically exposed systems produce. Think Google API + Amazon API + Flickr API with a bit of GMail thrown in. The developers of Flickr rightly pointed out they want to keep technical discussions directly related to the API on the mailing list."
           },
           "members": {
                 "_content": "7775"
           },
           "privacy": object{
                 "_content": "3"
           },
           "lang": null,
           "ispoolmoderated": 1,
           "throttle": object{
                 "count": "3",
                 "mode": "day"
           },
           "restrictions": object{
                 "photos_ok": 1,
                 "videos_ok": 1,
                 "images_ok": 1,
                 "screens_ok": 1,
                 "art_ok": 1,
                 "safe_ok": 1,
                 "moderate_ok": 0,
                 "restricted_ok": 0,
                 "has_geo": 0
           }
     },
     "stat": "ok"
}

flickr.photos.getExif
Extrae datos EXIF de una foto existente.

Argumentos: photo_id [required]: ID de la foto cuyos datos EXIF se van a extraer.

Autenticación: No

Respuesta

{

    "photo": {
          "id": "2332823355",
          "secret": "e603be40a2",
          "server": "2333",
          "farm": 3,
          "exif": [
               	  {
                      "tagspace": "TIFF",
                      "tagspaceid": 1,
                      "tag": 271,
                      "label": "Make",
                      "raw": {
                            "_content": "Canon"
                        }
                  },
               	  {
                      "tagspace": "TIFF",
                      "tagspaceid": 1,
                      "tag": 272,
                      "label": "Model",
                      "raw": {
                            "_content": "Canon EOS 350D DIGITAL"
                        }
                  },
               	// Rest of the exif data
            ]
      },
    "stat": "ok"
}

flickr.photos.geo.getLocation
Devuelve la latitud y longitud del lugar donde se tomó una foto específica.

Argumentos: photo_d [required]: ID de la foto cuya ubicación se debe conocer.

Autenticación: No

Respuesta

{
     "photo": object{
         "id": string"229097925",
         "location": object{
                 "latitude": -33.856874,
                 "longitude": 151.214672,
                 "accuracy": "16",
                 "context": "0",
                 "locality": {
                       "_content": "Sydney",
                       "place_id": "p50kaZyYAJx9BZHQ",
                       "woeid": "1105779"
                 },
                 "region": object{
                       "_content":"New South Wales",
                       "place_id": "puGzSeubAphuNnF2",
                       "woeid": "2344700"
                 },
                 "country": object{
                       "_content": "Australia",
                       "place_id": "om3Zr2abAphqrm3jdA",
                       "woeid": "23424748"
                 },
                 "place_id": string"p50kaZyYAJx9BZHQ",
                 "woeid": string"1105779"
           }
     },
    "stat": string"ok"
}

flickr.photos.getFavorites
Devuelve una lista de personas que han marcado la foto pasada como favorita.

Argumentos: photo_id [required]: ID de la foto en cuestión.

Autenticación: No

Respuesta

1	{
2	"photo": {
3	"person": [
4	{
5	"nsid": "39011391@N06",
6	"username": "derek1960",
7	"favedate": "1243834286"
8	},
9	// Rest of the photos
10	],
11	"id": "229097925",
12	"secret": "13a21546fb",
13	"server": "61",
14	"farm": 1,
15	"page": 1,
16	"pages": 2,
17	"perpage": 10,
18	"total": "18"
19	…},
20	"stat": "ok"
21	}

flickr.places.getTopPlacesList
Devuelve una lista de los 100 lugares más etiquetados por día.

Argumentos: place_type_id [required] - Identificación numérica de un lugar para definir cómo agrupar fotos.

Autenticación: No

Respuesta

{
     "places": object{
           "total": number100,
           "place": [
               {
                   "place_id": "4KO02SibApitvSBieQ",
                   "woeid": "23424977",
                   "latitude": "48.890",
                   "longitude": "-116.982",
                   "place_url": "/United+States",
                   "place_type": "country",
                   "place_type_id": "12",
                   "_content": "United States",
                   "photo_count": "23654"
               },
               // Rest of the 99 countries
            ],
           "date_start": 1248048000,
           "date_stop": 1248134399
      },
     "stat": "ok"
}

flickr.tags.getHotList
Devuelve una lista de las etiquetas más utilizadas para un período de tiempo determinado.

Argumentos: period : especifica el período para el que obtener etiquetas. count: especifica el número de etiquetas que se devolverán en la respuesta.

Autenticación: No

Respuesta

{
     "hottags": {
           "period": "day",
           "count": 20,
           "tag": [
               {
                  "score": "100",
                  "_content": "sundaystreets"
               },
               {
                  "score": "100",
                  "_content": "happymondayblues"
               },
               {
                  "score": "100",
                   "_content": "melbourneopenhouse2009"
               }
            ]
      },
     "stat": string"ok"
}

En conclusión

En esta parte inicial de la serie, vimos cómo trabajar con la API de Flickr, incluida la forma de recuperar datos públicos y privados, la autenticación con la API y cómo cargar datos al servicio. También echamos un vistazo a algunos de los métodos API más utilizados junto con sus respuestas JSON para comprender mejor la estructura de los datos que la API envía de vuelta.

La siguiente API que se cubre depende totalmente de usted. Aquí, en Net Tuts, satisfacemos la demanda popular, por lo que les permitiremos a ustedes, los lectores, decidir qué API de servicio se escribirá a continuación. En su comentario a continuación, deje el nombre del servicio y la interfaz API, si es necesario. Cubrimos REST en este artículo, pero nos complacería cubrir las API basadas en SOAP o XML-RPC si suficientes personas lo desean.

Preguntas? ¿Cosas bonitas que decir? ¿Críticas? Haz clic en la sección de comentarios y déjame un comentario. ¡Feliz codificación!

Síganos en Twitter o suscríbase a la fuente RSS de NETTUTS para obtener más artículos y artículos de desarrollo web diarios.