NAME

EVDB::API - Perl interface to EVDB public API

SYNOPSIS

  use EVDB::API;
  
  my $evdb = EVDB::API->new(app_token => $app_token);
  
  $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.6 - June 2005

CLASS METHODS

C(new)

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

Creates a new API object. Requires a valid app_token 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_token). Returns a data structure processed through XML::Simple.