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 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 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 . 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