flickr::api(3pm) [debian man page]

Flickr::API(3pm)					User Contributed Perl Documentation					  Flickr::API(3pm)

NAME

       Flickr::API - Perl interface to the Flickr API

SYNOPSIS

	 use Flickr::API;

	 my $api = new Flickr::API({'key'    => 'your_api_key',
				    'secret' => 'your_app_secret'});

	 my $response = $api->execute_method('flickr.test.echo', {
		       'foo' => 'bar',
		       'baz' => 'quux',
	       });

       or

	 use Flickr::API;
	 use Flickr::API::Request;

	 my $api = new Flickr::API({'key' => 'your_api_key'});

	 my $request = new Flickr::API::Request({
		       'method' => 'flickr.test.echo',
		       'args' => {},
	       });

	 my $response = $api->execute_request($request);

DESCRIPTION

       A simple interface for using the Flickr API.

       "Flickr::API" is a subclass of LWP::UserAgent, so all of the various proxy, request limits, caching, etc are available.

   METHODS
       "execute_method($method, $args)"
	   Constructs a "Flickr::API::Request" object and executes it, returning a "Flickr::API::Response" object.

       "execute_request($request)"
	   Executes a "Flickr::API::Request" object, returning a "Flickr::API::Response" object. Calls are signed if a secret was specified when
	   creating the "Flickr::API" object.

       "request_auth_url($perms,$frob)"
	   Returns a "URI" object representing the URL that an application must redirect a user to for approving an authentication token.

	   For web-based applications $frob is an optional parameter.

	   Returns undef if a secret was not specified when creating the "Flickr::API" object.

AUTHOR

       Copyright (C) 2004-2005, Cal Henderson, <cal@iamcal.com>

       Auth API patches provided by Aaron Straup Cope

SEE ALSO

       Flickr::API::Request, Flickr::API::Response, XML::Parser::Lite, <http://www.flickr.com/>, <http://www.flickr.com/services/api/>

perl v5.14.2							    2014-07-04							  Flickr::API(3pm)

XML::Atom::Client(3pm)					User Contributed Perl Documentation				    XML::Atom::Client(3pm)

NAME

       XML::Atom::Client - A client for the Atom API

SYNOPSIS

	   use XML::Atom::Client;
	   use XML::Atom::Entry;
	   my $api = XML::Atom::Client->new;
	   $api->username('Melody');
	   $api->password('Nelson');

	   my $entry = XML::Atom::Entry->new;
	   $entry->title('New Post');
	   $entry->content('Content of my post.');
	   my $EditURI = $api->createEntry($PostURI, $entry);

	   my $feed = $api->getFeed($FeedURI);
	   my @entries = $feed->entries;

	   my $entry = $api->getEntry($EditURI);

DESCRIPTION

       XML::Atom::Client implements a client for the Atom API described at http://bitworking.org/projects/atom/draft-gregorio-09.html, with the
       authentication scheme described at http://www.intertwingly.net/wiki/pie/DifferentlyAbledClients.

       NOTE: the API, and particularly the authentication scheme, are still in flux.

USAGE

   XML::Atom::Client->new(%param)
   $api->use_soap([ 0 | 1 ])
       XML::Atom::Client supports both the REST and SOAP-wrapper versions of the Atom API. By default, the REST version of the API will be used,
       but you can turn on the SOAP wrapper--for example, if you need to connect to a server that supports only the SOAP wrapper--by calling
       use_soap with a value of 1:

	   $api->use_soap(1);

       If called without arguments, returns the current value of the flag.

   $api->username([ $username ])
       If called with an argument, sets the username for login to $username.

       Returns the current username that will be used when logging in to the Atom server.

   $api->password([ $password ])
       If called with an argument, sets the password for login to $password.

       Returns the current password that will be used when logging in to the Atom server.

   $api->createEntry($PostURI, $entry)
       Creates a new entry.

       $entry must be an XML::Atom::Entry object.

   $api->getEntry($EditURI)
       Retrieves the entry with the given URL $EditURI.

       Returns an XML::Atom::Entry object.

   $api->updateEntry($EditURI, $entry)
       Updates the entry at URL $EditURI with the entry $entry, which must be an XML::Atom::Entry object.

       Returns true on success, false otherwise.

   $api->deleteEntry($EditURI)
       Deletes the entry at URL $EditURI.

   $api->getFeed($FeedURI)
       Retrieves the feed at $FeedURI.

       Returns an XML::Atom::Feed object representing the feed returned from the server.

   ERROR HANDLING
       Methods return "undef" on error, and the error message can be retrieved using the errstr method.

AUTHOR &; COPYRIGHT
       Please see the XML::Atom manpage for author, copyright, and license information.

perl v5.12.4							    2011-09-27						    XML::Atom::Client(3pm)