NAME

EVDB::API - Perl interface to EVDB public API

SYNOPSIS

use EVDB::API;

my $evdb = EVDB::API->new(app_key => $app_key);

$evdb->login(user => 'harry', password => 'H0gwart$') 
  or die "Can't log in: $EVDB::API::errstr";

my $event = $evdb->call('events/get', {id => 'E0-001-000218163-6'})
  or die "Can't retrieve event: $EVDB::API::errstr";

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

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

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

DESCRIPTION

The EVDB API allows you to build tools and applications that interact with EVDB, the Events & Venues Database. This module provides a Perl interface to that API, including the digest-based authentication infrastructure.

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

AUTHOR

Copyright 2005 EVDB, Inc. All rights reserved.

VERSION

0.8 - July 2005

CLASS METHODS

C(new)

$evdb = EVDB::API->new(app_key => $app_key);

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

OBJECT METHODS

login

$evdb->login(user => $username, password => $password);
$evdb->login(user => $username, password_md5 => $password_md5);

Retrieves an authentication token from the EVDB API server.

call

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

Calls the specified method with the given arguments and any previous authentication information (including app_key). Returns a data structure processed through XML::Simple.