Nominet (.UK Registry) System Changes

Description

 

Definition

This document is designed to provide resellers with technical details about the changes to the .UK name space. Nominet, the .UK Registry, has updated their Registry system to support the ability for Resellers to register and renew .UK domain names for single or multi-year terms.

Usage

Use this sample command to purchase a real-time domain registration (single or multi-year terms).

 

Multi-Year Registrations and Renewals

 

Current Behavior

eNom's API requires all new .UK registrations and .UK renewals to be executed at a two-year minimum.

New Behavior

  • Registrations: multi-year (1-10)
  • Renewals: multi-year (1-10)
  • Renewals availability: any time (no longer restricted to 6 months prior to expiration date)

Required or Optional

This change is optional. Resellers do not have to update their systems for this change. Our API will remain backwards compatible.

Dates

  • ResellerTest Server : April 4th, 2012
  • Live Server : May 1st, 2012

Real-Time Response

 

Current Behavior

eNom's API currently operates in a non-real time manner for .UK. Our system centers on a 1300 Response Code (RRPCode) for .UK registrations. Resellers send in their .UK registration commands and expect to receive a 1300 Response Code. This code signifies that the registration is not real-time and thus the Reseller must "poll" the domain and/or Order to confirm it has been processed by the Registry.

New Behavior

eNom will be eliminating the use of the 1300 Response Code for .UK registrations. We will be updating our API to work in real-time with the .UK registry. Once we make this change, our API will return a 200 Response Code (RRPCode). The 200 Response Code indicates that the order was processed immediately. To be clear, we will no longer return a 1300 Response Code for .UK after this change.

Required or Optional

This change is required. Once we go live with this change, any Resellers who have not made this update will see failures in processing UK registrations. To ensure this does not happen, we are giving Resellers a 60 Day Notice to accommodate this change.

Dates

  • ResellerTest Server : April 4th, 2012
  • Live Server : June 1st, 2012

API Real-Time Purchase Sample

Definition

Purchase a .UK domain name in real time

Base parameters

  • SLD: second level domain name
  • TLD: top level domain name
  • NumYears: number of years to register the name. Permitted values are 1 to 10

Extended Attributes are required for all .UK domain name. Please use GetExtAttributes command to get detailed information for the required parameters below.

Registered_For: legal type of registrant contact

UK_Legal_Type: company or person domain is registered for (this must be accurate and CANNOT BE CHANGED)

UK_Reg_Opt_Out: hide registrant data in Nominet WHOIS

Query

http://resellertest.enom.com/interface.asp?
UID=resellid&PW=resellpw&ResponseType=XML&Command=PURCHASE
&EndUserIP=123.123.123.123&UseDNS=default&NumYears=1
&Registered_For=MyName&UK_Legal_Type=IND&UK_Reg_Opt_Out=no
&TLD=co.uk&SLD=mydomain

Output

Old version:

<?xml version="1.0" ?>

<interface-response>

<OrderID>147805511</OrderID>

<TotalCharged>50.99</TotalCharged>

<RegistrantPartyID>{39AAA8C0-D019-

4690-1199-FD632BC123AA}

</RegistrantPartyID>

<RRPCode>1300</RRPCode>

<RRPText>Command completed

successfully - 147805511

</RRPText>

<Command>PURCHASE</Command>

<Language>eng</Language>

<ErrCount>0</ErrCount>

<ResponseCount>0</ResponseCount>

<MinPeriod>1</MinPeriod>

<MaxPeriod>10</MaxPeriod>

<Server>RESELLERTEST</Server>

<Site>eNom</Site>

<IsLockable>False</IsLockable>

<IsRealTimeTLD>False</IsRealTimeTLD>

<TimeDifference>+00.00

</TimeDifference>

<ExecTime>3.781</ExecTime>

<Done>true</Done>

<RequestDateTime>4/1/2012 1:30:32

PM</RequestDateTime>

</interface-response>

 

New version:

<?xml version="1.0" ?>

<interface-response>

<OrderID>157804547</OrderID>

<TotalCharged>50.99</TotalCharged>

<RegistrantPartyID>{39AAA8C0-D019-

4690-1199-FD632BC123AA}

</RegistrantPartyID>

<RRPCode>200</RRPCode>

<RRPText>Command completed

successfully - 157804547

</RRPText>

<Command>PURCHASE</Command>

<Language>eng</Language>

<ErrCount>0</ErrCount>

<ResponseCount>0</ResponseCount>

<MinPeriod>1</MinPeriod>

<MaxPeriod>10</MaxPeriod>

<Server>RESELLERTEST</Server>

<Site>eNom</Site>

<IsLockable>False</IsLockable>

<IsRealTimeTLD>True</IsRealTimeTLD>

<TimeDifference>+00.00

</TimeDifference>

<ExecTime>1.021</ExecTime>

<Done>true</Done>

<RequestDateTime>3/26/2012 2:10:31

PM</RequestDateTime>

</interface-response>

 

Get extended attributes

Definition

Retrieve extended attributes required for registration

Base parameters

tld: co.uk, org.uk, etc...

Query

http://resellertest.enom.com/interface.asp?
Command=GetExtAttributes&UID=resellid&PW=resellerpw
&ResponseType=XML&TLD=co.uk

Output

<interface-response>

<?xml version="1.0" ?>

<interface-response>

<Attributes>

<Attribute>

<ID>6</ID>

<Name>uk_legal_type</Name>

<Application>2</Application>

<UserDefined>False</UserDefined>

<Required>1</Required>

<Description>Legal type of registrant contact</Description>

<IsChild>0</IsChild>

+ <Options>

......... <cut> .........

</Attribute>

</Attributes>

<Command>GETEXTATTRIBUTES</Command>

<Language>eng</Language>

<ErrCount>0</ErrCount>

<ResponseCount>0</ResponseCount>

<MinPeriod>1</MinPeriod>

<MaxPeriod>10</MaxPeriod>

<Server>RESELLERTEST</Server>

<Site>eNom</Site>

<IsLockable>False</IsLockable>

<IsRealTimeTLD>True</IsRealTimeTLD>

<TimeDifference>+00.00</TimeDifference>

<ExecTime>0.641</ExecTime>

<Done>true</Done>

<RequestDateTime>3/26/2012 2:35:43 PM</RequestDateTime>

</interface-response>