Hi all,
We've added a few new "extras" options for API calls that return a
Standard Photo Response (SPR). If you're not sure what a SPR is, you
should start with Kellan's blog post on the subject:
http://code.flickr.com/blog/2008/08/19/standard-photos-response-apis-for-civiliz\
ed-age/
They are:
* path_alias : This returns the user's Flickr URL, as in /photos/straup.
In keeping with the generally erratic naming conventions in the rest
of the API you pass the extra with an underbar and read the value from
an attribute without one. For example, extras=path_alias yields <photo
pathalias="foo">.
It is also worth remembering that a user may not have configured their
Flickr URL so you should be ready to fall back on @ownerid to get the
user's user_id.
* url_sq, url_t, url_s, url_m, url_o : These are convenience flags to
request both the (image) URL and the dimensions for a given photo size.
The suffixes correspond to the available image sizes as described in
the building photo URLs documentation:
http://www.flickr.com/services/api/misc.urls.html
Lots of developer's have complained about having to call
photos.getSizes when using SPR methods so hopefully this will make
life a little easier.
You'll need to specify each "size" (that's the _t, _m etc. part) you
want to have returned in the response. Presumably people only need one
or two sizes for their application so please use these judiciously.
Also, "url_o" may be empty if the photo owner does not allow their
original photos to be downloaded.
Enjoy!