Peter Pentchev > WWW-Domain-Registry-Joker-0.10 > WWW::Domain::Registry::Joker

Download:
WWW-Domain-Registry-Joker-0.10.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.10   Source  

NAME ^

WWW::Domain::Registry::Joker - an interface to the Joker.com DMAPI

SYNOPSIS ^

  use WWW::Domain::Registry::Joker;

  $reg = new WWW::Domain::Registry::Joker('username' => 'testuser',
    'password' => 'secret', 'debug' => 1);

  @res = $reg->result_list();

  eval {
    $procid = $reg->do_request('ns-create', 'Host' => 'a.ns.example.com',
      'IP' => '192.168.13.1');
  };
  if ($@) {
    warn("Joker request failed: $@\n");
  }

DESCRIPTION ^

The WWW::Domain::Registry::Joker module provides a Perl interface to the Domain Management API (DMAPI) used by the Joker.com DNS registrar. It is designed to help Joker.com resellers in automating the domain registration and all the other relevant actions.

The recommended usage of the WWW::Domain::Registry::Joker class is to create an object, initialize it with the Joker.com reseller's username and password, and then use it to send all the DMAPI requests. This will take care of caching both login credentials and network connections (at least as far as LWP takes care of caching connections to the same webserver).

In most cases it is not necessary to invoke the login() method explicitly, since all the "real" action methods check for an authentication token and invoke login() if there is none yet.

METHODS ^

The WWW::Domain::Registry::Joker class defines the following methods:

EXAMPLES ^

Initialize a WWW::Domain::Registry::Joker object with your reseller's username and password:

  $jreq = new WWW::Domain::Registry::Joker('username' => 'me@example.com',
        'password' => 'somekindofsecret');

Fetch the list of pending and processed requests and their status:

  %h = $jreq->result_list();
  foreach (sort { $a->{'procid'} cmp $b->{'procid'} } values %h) {
        print join("\t",
            @{$_}{qw/tstamp svtrid procid reqtype reqobject status cltrid/}).
            "\n";
  }

Register a new nameserver:

  eval {
        $jreq->do_request('ns-create', 'Host' => 'a.ns.example.net',
            'IP' => '192.168.13.7');
  };
  print STDERR "ns-create error: $@\n" if ($@);

Maybe some more examples are needed here :)

ERRORS ^

All the user-invoked methods die on any Joker.com errors with a suitable error message placed in $@.

SEE ALSO ^

https://joker.com/faq/category/39/22-dmapi.html - the Joker.com DMAPI documentation

BUGS ^

HISTORY ^

The WWW::Domain::Registry::Joker class was written by Peter Pentchev in 2007.

AUTHOR ^

Peter Pentchev, <roam@ringlet.net>

COPYRIGHT AND LICENSE ^

Copyright (C) 2007 - 2009 by Peter Pentchev

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

syntax highlighting: