NAME

WWW::TBA::API - Perl module for handling thebluealliance.net's API

VERSION

Version 1.00

SYNOPSIS

$tba=new WWW::TBA::API($apikey);

DESCRIPTION

WWW::TBA::API implements version 1 of thebluealliance.net's API. More information is available here: http://thebluealliance.net/tbatv/api/readme.php.

This implementation is deliberately similar to the other implementations (esecially the one written in php), so that people switching will not have trouble learning the new one.

FUNCTIONS

new API_KEY [API_URL]

Creates an interface to the API. If API_URL is specified, queries are made to that URL. With ordinary usage, it should never be specified (the default, http://thebluealliance.net/tbatv/api.php, should not change).

makearray

Not implemented. In other implementations, makes an array out of an XML::Simple object. This should not be necessary, or even remotely desirable, in Perl.

->user_agent [LWP::UserAgent]

Returns the old user agent, and changes if necessary.

->api_key [API_KEY]

Returns the old api key, and changes if necessary.

->api_url [API_URL]

Returns the old api url, and changes if necessary.

->api_version

Returns the version of the API being used. This value cannot be changed, for obvious reasons.

->query METHOD ARGUMENTS

The low-level API call. Makes a query to TBA of METHOD with ARGUMENTS. ARGUMENTS must be a reference to a hash.

->raw_query METHOD ARGUMENTS

Same as query, but returns a string instead of an XML::Simple object. Generally for debugging purposes only.

->get_teams [STATE [TEAMNUMBER]]

Gets inormation on the specified teams.

->get_events [YEAR [WEEK [EVENTID]]]

Gets information on the specified events.

->get_matches [COMPLEVEL [EVENTID [TEAMNUMBER [MATCHID]]]]

Returns information on the specified matches.

->get_attendance [EVENTID [TEAMNUMBER]]

Returns the attendance list for the specified event.

->get_official_record [TEAMNUMBER [YEAR [EVENTID]]]

Returns the official record of the team.

->get_elim_sets EVENTID NOUN

Undocumented.

BUGS AND LIMITATIONS

The error handling for this module is currently less than spify. Any errors in fetching or parsing XML will cause undefined behaviour.

Please report any bugs or feature requests to bug-www-tba-api at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-TBA-API. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

AUTHOR

Scott Lawrence (bytbox@gmail.com)

COPYRIGHT AND LICENSE

Copyright 2009 Scott Lawrence, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.