Flickr API is a Java / android implementation to access the Flickr web services defined here. The API uses only the REST-JSON requests to have the minimum payload size (which is useful with android device which do not have a high speed network access).
The API use the following dependencies:
- httpmime to use large data in httpclient
- json to read the web services responses (not needed for android)
- scribe to use the OAuth authentication
The calls to Flickr are quiet easy:
Flickr flickr = new Flickr("my.api.key", "my.api.secret", "http://localhost/callback", new File("flickr.conf"));
// Check if a user is already logged
if(!flickr.isLogged()) {
// Get the authorization URL to allow the application to use the Flickr services
String url = flickr.getAuthorizationUrl();
// Show the previous URL in a browser
...
// Verify the token
String verifier = ...;
String token = ...;
flickr.verifyToken(verifier, token);
}
// Authenticate the user
UserInfo user = flickr.authenticate();
// Use the services
Paginated<Photo> photos = flickr.getPhotosService().getRecentlyUpdated(50, 0);
...
The library do not supports all Flickr features. Here are the supported :
- get the users contacts
- get the cameras brand list
- get the favorites photos of users
- get the users galleries
- get the groups and their photos
- get the people (search user, get users informations ...)
- get the photos and the sets
- get the statistics on photos, set ...
- upload new photos