Flickr: Scheme API for Flickr

David Van Horn <dvanhorn@ccs.neu.edu>

(require (planet dvanhorn/flickr:2:0))

1 Overview

This collection provides a Scheme wrapping to the Flickr web service:

http://www.flickr.com/services/api/

See example.ss for a example program that logs in a user and makes authenticated calls to the API.

Procedures are named exactly as in the Flickr API. Arguments are specified with keywords spelled exactly as in the API, their values must always be strings.

Calling a procedure returns a list of Xexprs constituting the [xml-payload-here] portion of the response (see the Flickr documentation on example responses).

Here is an example call to the echo method (the value of the api_key should be changed to your own key, assigned by Flickr).

Example:

> (flickr.test.echo #:api_key "138427ce2d97d6a2d0c4a2f045a59bfa")

((method () "flickr.test.echo") (api_key () "138427ce2d97d6a2d0c4a2f045a59bfa"))

If the Flickr service responds with an error response, an exception is raised.

Examples:

> (current-api-key "138427ce2d97d6a2d0c4a2f045a59bfa")

> (flickr.test.echo)

((method () "flickr.test.echo") (api_key () "138427ce2d97d6a2d0c4a2f045a59bfa"))

Methods may have required arguments and an error will be raised if ommitted.

For example:

  (flickr.reflection.getMethods)

Evaluates to:

'((methods

()

"\n\t"

(method () "flickr.activity.userComments")

"\n\t"

(method () "flickr.activity.userPhotos")

"\n\t"

...))

Whereas:

(parameterize ((non-text-tags (cons 'methods (non-text-tags))))

(flickr.reflection.getMethods))

Evaluates to:

'((methods

()

(method () "flickr.activity.userComments")

(method () "flickr.activity.userPhotos")

...))

2 Methods