Interfacing with eNom’s URL Interface using the Enom.EnomURL COM object

It is possible to interface with eNom’s URL interface easily using the supplied COM object named Enom.EnomURL in the file URLInterface.dll.

Installing the object
Copy the URLInterface.dll file to a directory on the machine you will be using it on, and register it using regsvr32.exe at a DOS prompt in that directory. There are two registry entries in HKEY_LOCAL_MACHINE/SOFTWARE/Enom/URL Interface/, “ServerIP” (the address of the server to connect to) and “ServerURL” (the page to request on the server). We will provide you with the IP of the server you need to connect to.

A transaction with the COM object consists of the following

1. Set the properties required for the specific command you are using
2. Call the method for the command
3. Check to see if any errors were returned from the transaction

You will find a list of required properties for each command below, along with the method to call to invoke that command. To check for errors, you need to call the Response method.

The Response method obtains values that were returned to the COM object during the transaction with eNom. The eNom server will return a number of name & value pairs. To retrieve one, use the following syntax:

Value = (obj name).Response( Name )

To see if there were any errors, check the “ErrCount” value. If this value is 0, the command completed successfully. Otherwise, retrieve each error string. These are stored in values named “Err” plus the error number. So if there was one error, you would get the error string by doing the following:

ErrString = (obj name).Response( “Err1” )

To retrieve the RRP status from the operation (if no errors occurred) get the following values:

RRPCode	Result code for the operation
RRPText	Text string describing code

Check If Domain Name Available - Required parameters:

Sld	Second level domain name
Tld	Top level domain name

Method: Check

RRPCode:
210	Domain available
211	Domain not available

You can use the Check command to check .com .net and .org all at the same time for a given SLD. Specify “*” for the TLD and all top level domains will be checked. In response you will get: (where <x> is a number from 1 to 3)

Domain<x>	Full domain name that was checked
RRPCode<x>	RRP code for this domain check
RRPText<x>	RRP text for this domain check

Purchase Domain Name - Required parameters:

Uid	Your username
Pw	Your password
Sld	Second level domain name
Tld	Top level domain name

You need to specify what name server(s) will serve your domain. You can either use eNom name servers by setting this property to “eNom”: UseDNS = “eNom”

Or you can specify your own name servers by calling this function (maximum of 12 name servers):

AddNameServer( NameServer)

The following properties are optional:

RegisterYears	Number of years to register the name for (1-12). If this is not specified, the default specified for your account is used instead.
RegistrantAddress1 RegistrantAddress2 RegistrantCity RegistrantCountry RegistrantEmailAddress RegistrantFax RegistrantFirstName RegistrantJobTitle RegistrantLastName RegistrantOrganizationName RegistrantPhone RegistrantPostalCode RegistrantStateProvince RegistrantStateProvinceChoice	Registrant contact information
TechAddress1 TechAddress2 TechCity TechCountry TechEmailAddress TechFax TechFirstName TechJobTitle TechLastName TechOrganizationName TechPhone TechPostalCode TechStateProvince TechStateProvinceChoice	Technical contact information
AdminAddress1 AdminAddress2 AdminCity AdminCountry AdminEmailAddress AdminFax AdminFirstName AdminJobTitle AdminLastName AdminOrganizationName AdminPhone AdminPostalCode AdminStateProvince AdminStateProvinceChoice	Administrative contact information
AuxBillingAddress1 AuxBillingAddress2 AuxBillingCity AuxBillingCountry AuxBillingEmailAddress AuxBillingFax AuxBillingFirstName AuxBillingJobTitle AuxBillingLastName AuxBillingOrganizationName AuxBillingPhone AuxBillingPostalCode AuxBillingStateProvince AuxBillingStateProvinceChoice	Auxiliary contact information

Method: Purchase

If there were no errors and RRPCode was 200, then the domain name was registered. Otherwise, there was an error (most likely the name was already registered).

Email Forwarding - Required parameters:

Uid	Your username
Pw	Your password
Sld	Second level domain name
Tld	Top level domain name

Email addresses to forward are required. Use this method to add them (maximum of 5 email addresses):

AddEmail( Email, ForwardToEmail )

Method: ForwardEmail

URL Forwarding - Required parameters:

Uid	Your username
Pw	Your password
Sld	Second level domain name
Tld	Top level domain name
Pageurl	URL to forward www.<sld>.<tld> to

Method: SetPageURL

Getting the Result of a Previous Operation - Required parameters:

Uid	Your username
Pw	Your password
Reference	The same reference number you passed to the original command.

Set the Reference property to a unique value before running any command through the COM object. You can get the RRPCode and RRPText values from the command at a later time by setting the Reference property to the same value as before and calling the GetResult method.

Set Domain Password - Required parameters:

Uid	Your username
Pw	Your password
Sld	Second level domain name
Tld	Top level domain name

Method: SetDomainPassword( NewPassword, AccessLevel )

AccessLevel can be either 0 or 1. 1 means all access, 0 means restricted access.

Getting Your Balance

If you set the property GetBalance to 1 before performing any of the above operations, your balance will be returned in the value named “Balance”.

Field Lengths

* in Table below indicates either Registrant, Tech, Admin, or Aux.

Field Name	Maximum Length
*OrganizationName	60
*JobTitle	60
*FirstName	60
*LastName	60
*Address1	60
*Address2	60
*City	60
*StateProvince	60
*StateProvinceChoice ("State" or "Province")	20
*PostalCode	15
*Country	60
*Phone	20
*Fax	20
*EmailAddress	128
Uid	20
Password	20
SLD	63
TLD	15
Email (AddEmail())	30
ForwardToEmail (AddEmail())	130
NameServer (AddNameServer())	60
PageURL	130