NAME

WWW::LogicBoxes::Contact - Representation of Domain Contact

SYNOPSIS

    use strict;
    use warnings;

    use WWW::LogicBoxes::Customer;
    use WWW::LogicBoxes::Contact;

    my $customer = WWW::LogicBoxes::Customer->new( ... ); # Valid LogicBoxes Customer

    my $contact = WWW::LogicBoxes::Contact->new(
        id           => 42,
        name         => 'Edsger Dijkstra',
        company      => 'University of Texas at Austin',
        email        => 'depth.first@search.com',
        address1     => 'University of Texas',
        address2     => '42 Main St',
        city         => 'Austin',
        state        => 'Texas',
        country      => 'US',
        zipcode      => '78713',
        phone_number => '18005551212',
        fax_number   => '18005551212',
        type         => 'Contact',
        customer_id  => $customer->id,
    );

DESCRIPTION

Representation of a LogicBoxes domain contact.

ATTRIBUTES

id

Contacts that have actually been created will have an id assigned for them. A predicate exists 'has_id' that can be used to check to see if an id has been assigned to this contact. A private writer of _set_id is also provided.

name

company

Company of the contact. This is a required field so if there is no company some sentinal string of "None" or something similiar should be used.

email

address1

address2

Predicate of has_address2.

address3

Predicate of has_address3.

city

state

This is the full name of the state, so Texas rather than TX should be used. Not all regions in the world have states so this is not a required field, a predicate of has_state exists.

country

The ISO-3166 code for the country. For more information on ISO-3166 please see Wikipedia.

zipcode

phone_number

Be sure to include the country code. When it comes to the phone number a string or Number::Phone object can be provided and it will be coerced into the WWW::LogicBoxes::PhoneNumber internal representation used.

fax_number

Predicate of has_fax_number

type

The type of contact, NOT TO BE CONFUSED with what this contact is being used for on a domain. This IS NOT Registrant, Billing, Admin, or Technical. The default value is 'Contact' and you almost never want to change this.

customer_id

The id of the customer that this contact is assoicated with.

METHODS

These methods are used internally, it's fairly unlikely that consumers will ever call them directly.

construct_creation_request

    my $logic_boxes = WWW::LogicBoxes->new( ... );
    my $contact     = WWW::LogicBoxes::Contact->new( ... );

    my $response = $logic_boxes->submit({
        method => 'contacts__add',
        params => $contact->construct_creation_request(),
    });

Converts $self into a HashRef suitable for creation of a contact with LogicBoxes

construct_from_response

    my $logic_boxes = WWW::LogicBoxes->new( ... );

    my $response = $logic_boxes->submit({
        method => 'contacts__details',
        params => {
            'contact-id' => 42,
        }
    });

    my $contact = WWW::LogicBoxes::Contact->construct_from_response( $response );

Creates an instance of $self from a LogicBoxes response.

SEE ALSO

For .us domains WWW::LogicBoxes::Contact::US must be used for at least the registrant contact.

cpanm WWW::LogicBoxes

perl -MCPAN -e shell
install WWW::LogicBoxes