NAME
WebService::Flattr - An interface to Flattr's social micro-payment API
SYNOPSIS
use WebService::Flattr();
my $flattr = WebService::Flattr->new;
my $thing = $flattr->thing_exists("http://www.example.com/")->data;DESCRIPTION
This module provides an interface to the http://flattr.com/ social micropayment system.
Flattr have documented their interface at http://developers.flattr.net/api/.
Currently, this module only implements part of Flattr's interface. Future versions will implement more features.
METHODS
Constructor
new
my $flattr = WebService::Flattr->new();This returns a Net::Flattr object to call "Request Methods" on.
Request Methods
The following request methods perform actions against Flattr's API. Each method returns a WebService::Flattr::Response method on success and dies on failure.
user_flattrs
Takes a list or hash reference containing the following arguments:
username (mandatory), count (optional), page (optional).
http://developers.flattr.net/api/resources/flattrs/#list-a-users-flattrs
get_thing
Takes one argument, the ID of a thing.
http://developers.flattr.net/api/resources/things/#get-a-thing
thing_exists
Takes one argument, the URL of a thing.
http://developers.flattr.net/api/resources/things/#check-if-a-thing-exists.
search_things
Takes optional arguments either as a list or a hash reference.
http://developers.flattr.net/api/resources/things/#search-things
user
Takes one argument, a string containing a username.
http://developers.flattr.net/api/resources/users/#get-a-user
user_activities
Takes one argument, a string containing a username.
http://developers.flattr.net/api/resources/activities/#list-an-users-activities
categories
Takes no arguments.
http://developers.flattr.net/api/resources/categories/#list-categories
languages
Takes no arguments.
http://developers.flattr.net/api/resources/languages/#list-all-available-languages
BUG REPORTS
Please submit bug reports to https://rt.cpan.org/Public/Dist/Display.html?Name=WebService-Flattr.
If you would like to send patches, please send a git pull request to bug-WebService-Flattr@rt.cpan.org. Thank you in advance for your help.
SEE ALSO
http://developers.flattr.net/api/
AUTHOR
Tom Hukins