WWW::Phanfare::API - Perl wrapper for Phanfare API
Version 0.09
Create agent. Developer API keys required.
use WWW::Phanfare::API; my $api = WWW::Phanfare::API->new( api_key => 'xxx', private_key => 'yyy', );
Authentication with account:
my $session = $api->Authenticate( email_address => 'my@email', password => 'zzz', ) die "Cannot authenticate: $session->{code_value}" unless $session->{'stat'} eq 'ok'; my $target_uid = $session->{session}{uid};
Or authenticate as guest:
$api->AuthenticateGuest();
Get list of albums:
my $albumlist = $api->GetAlbumList( target_uid => $session->{session}{uid} )->{albums}{album}; printf( "%s %s %s\n", $_->{album_id}, substr($_->{album_start_date}, 0, 10), $_->{album_name} ) for @$albumlist;
Create new album, upload an image to it and delete it all again.
my $album = $api->NewAlbum( target_uid => $target_uid, ); my $album_id = $album->{album}{album_id}; my $section_id = $album->{album}{sections}{section}{section_id}; my $content = read_file('IMG_1234.jpg', binmode => ':raw'); my $image = $api->NewImage( target_uid => $target_uid, album_id => $album_id, section_id => $section_id, filename => 'IMG_1234.jpg', content => $content, ); my $del_album = $api->DeleteAlbum( target_uid => $target_uid, album_id => $album_id, );
Load an image.
my $image = $api->geturl( $url );
Perl wrapper the Phanfare API. A developer API key is required for using this module.
Refer to methods and required parameters are listed on http://help.phanfare.com/index.php/API .
api_key and private_key is only required for the constructor, not for individual methods.
Methods return hash references. The value of the 'stat' key will be 'ok' if the call succeeded. Value of 'code_value' key has error message.
Create a new API agent.
Load data from URL.
Soren Dossing, <netcom at sauber.net>
<netcom at sauber.net>
Please report any bugs or feature requests to bug-www-phanfare-api at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Phanfare-API. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-www-phanfare-api at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc WWW::Phanfare::API
You can also look for information at:
Github's request tracker
https://github.com/sauber/p5-www-phanfare-api/issues
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/WWW-Phanfare-API
CPAN Ratings
http://cpanratings.perl.org/d/WWW-Phanfare-API
Search CPAN
http://search.cpan.org/dist/WWW-Phanfare-API/
Official Phanfare API Refence Guide
http://help.phanfare.com/index.php/API
Copyright 2010 Soren Dossing.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
To install WWW::Phanfare::API, copy and paste the appropriate command in to your terminal.
cpanm
cpanm WWW::Phanfare::API
CPAN shell
perl -MCPAN -e shell install WWW::Phanfare::API
For more information on module installation, please visit the detailed CPAN module installation guide.