NAME

WebService::Eventful - Perl interface to Eventful public API

SYNOPSIS

use WebService::Eventful;
use Data::Dumper;

my $evdb = WebService::Eventful->new(app_key => $app_key);

# call() accepts either an array ref or a hash ref.
my $event = $evdb->call('events/get', {id => 'E0-001-000218163-6'})
  or die "Can't retrieve event: $WebService::Eventful::errstr";

print "Title: $event->{title}\n";

my $venue = $evdb->call('venues/get', [id => $event->{venue_id}])
  or die "Can't retrieve venue: $WebService::Eventful::errstr";

print "Venue: $venue->{name}\n";

$evdb->setup_Oauth (
consumer_key    => "Your_Consumer_Key",
consumer_secret => "Your_Consumer_Secret",
oauth_token     => "Your_Oauth_Token",
oauth_secret    => "Your_Oauth_Token_Secret");

my $locs = $evdb->call('users/locales/list' ) or die "Can't retrieve user locales : $WebService::Eventful::errstr";

print "Your locations are => " . Dumper ($locs) . "\n";

DESCRIPTION

The Eventful API allows you to build tools and applications that interact with Eventful. This module provides a Perl interface to that API, including oauth authentication .

See http://api.eventful.com/ for details.

AUTHORS

Copyright 2013 Eventful, Inc. All rights reserved.

You may distribute under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl README file.

ACKNOWLEDGEMENTS

Special thanks to Daniel Westermann-Clark for adding support for "flavors" of plug-in parsers. Visit Podbop.org to see other cool things made by Daniel.

VERSION

1.01 - September 2006 1.03 - August 2013 1.05 - Sept 2013

CLASS METHODS

new

$evdb = WebService::Eventful->new(app_key => $app_key);

Creates a new API object. Requires a valid app_key as provided by Eventful.

You can also specify an API "flavor", such as yaml, to use a different format.

$evdb = WebService::Eventful->new(app_key => $app_key, flavor => 'yaml');

Valid flavors are rest, yaml, and json.

OBJECT METHODS

setup_Oauth

$evdb->setup_Oauth(consumer_key => 'CoNsUmErKey', consumer_secret => 'CoNsUmErSeCrEt', oauth_token => 'AcCeSsToKeN', oauth_secret => 'SeCrEtToKeN');

Sets up the OAuth parameters that will be used to construct the Authorization header with an oauth signature computed on the parameters of the call.

call

$data = $evdb->call($method, \%arguments, [$force_array]);

Calls the specified method with the given arguments and any previous authentication information (including app_key). Returns a hash reference containing the results.

cpanm WebService::Eventful

perl -MCPAN -e shell
install WebService::Eventful