Michael Greb > WebService-Linode-0.03 > WebService::Linode

Download:
WebService-Linode-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
Report a bug
Module Version: 0.03   Source   Latest Release: WebService-Linode-0.05

NAME ^

WebService::Linode - Perl Interface to the Linode.com API.

VERSION ^

Version 0.03

SYNOPSIS ^

This module provides a simple OOish interface to the Linode.com API.

Example usage:

        use WebService::Linode;

        my $api = new WebService::Linode(apikey => 'mmmcake');
        my $data = $api->do_request( action => 'listDomains' );

METHODS ^

new

All methods take the same parameters as the Linode API itself does. Field names should be lower cased. All caps fields from the Linode API will be lower cased before returning the data.

Accepts a hash as an argument. apikey is the only required parameter specifying your Linode API key.

Errors mirror the perl DBI error handling method. $WebService::Linode::err and ::errstr will be populated with the last error number and string that occurred. All errors generated within the module are currently error code -1. By default, will warn on errors as well, pass a true value for fatal to die instead or nowarn to prevent the warnings.

verbose is 0-10 with 10 being the most and 0 being none

nocache disables some cacheing of domainname -> domainid

send_request

Sends a request to the API, takes a hash of name=>value pairs. Returns an HTTP::Response object.

parse_response

Takes an HTTP::Response object and parses the API response returning just the DATA section.

do_request

Executes the send_request method, parses the response with the parse_response method and returns the data.

AUTHOR ^

Michael Greb, <mgreb@linode.com>

BUGS ^

This module does not yet support the Linode API batch method, patches welcome.

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

SUPPORT ^

You can find documentation for this module with the perldoc command.

    perldoc WebService::Linode

You can also look for information at:

ACKNOWLEDGEMENTS ^

COPYRIGHT & LICENSE ^

Copyright 2008 Linode, LLC, all rights reserved.

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