User authentication

Some methods require authentication. To authenticate, first call the login() method, then pass the authentication token returned (in the authToken field of the return struct) as a parameter called authToken to the method you wish to call.

Undoubtably there will be more methods of getting auth tokens in future; we plan to implement something like the flickr authentication API at some point (although most likely without the mandatory registration).