NAME
WWW::DreamHost::API - Perl interface to DreamHost Web Panel API
VERSION
1.04
SYNOPSIS
my $key = '6SHU5P2HLDAYECUM';
my $api = new WWW::DreamHost::API($key);
my $res = $api->command('api-list_accessible_cmds');
print Data::Dumper->Dump([$res]);DESCRIPTION
WWW::DreamHost::API provides a simple Perl interface to DreamHost Web Panel API.
Read more about API commands at http://wiki.dreamhost.com/Application_programming_interface
METHODS
new ( $key )
Creates WWW::DreamHost::API object
uuid ( )
Returns UUID. Probably actually unique (randomly based on key and run time). Don't worry, if it's not, because it's reinitializing in case of failure (though I cannot imagine how it can happen).
reinit ( )
If unique check fails, attempt to re-initialize. You don't have to call it yourself.
command ( $cmd, [ $param => $value, ]+ )
Execute a command.
To get a list of availible commands, use something like that:
my $res = $api->command('api-list_accessible_cmds');
if ($res->{'success'}) {
my @commands = @{ $res->{'data'} };
}Returns a hash reference with (usually) 'result' and 'data' keys. 'result' can be 'success' or 'error', and 'data' depends on command executed.
See http://wiki.dreamhost.com/Application_programming_interface for more details.
CONFIGURATION AND ENVIRONMENT
WWW::DreamHost::API is based on libwww-perl which uses Crypt::SSLeay or IO::Socket::SSL, with all consequences: HTTPS_proxy environment variable and so on. See LWP documentation unless you're already familiar with it.
DEPENDENCIES
LWP::UserAgent Crypt::SSLeay Data::UUID LWP::protocol::https
If JSON.pm is installed, JSON format is used when making requests to API; otherwise Data::Dumper format is used. Note that Data::Dumper format is "eval"-ed so (in theory) it can be used for security breach.
INCOMPATIBILITIES
Not known.
BUGS AND LIMITATIONS
Not known, but test suite MAY fail if DreamHost adds some other commands or change their behaviour. If you are using CPAN::Reporter in your service, I'll know about it. Consider installing it, as it really helps authors to know about possible bugs. See http://wiki.cpantesters.org/wiki/QuickStart.
AUTHOR
Serguei Trouchelle stro@cpan.org
LICENSE AND COPYRIGHT
This module is distributed under the same terms as Perl itself.
Copyright (c) 2009-2012 Serguei Trouchelle