Revision as of 12:09, 20 February 2015

Premium Domain Names Lists - SHOWING SOON

APIs

Below you will find an example "CheckDomains" command for a so called "Premium" domain:
REQUIRED

[COMMAND]
command = CheckDomains
domain0 = <DOMAIN>
premiumchannels = *
EOF

[RESPONSE]
PROPERTY[PREMIUMCHANNEL][0]=RIGHTSIDE
PROPERTY[PRICE][0]=xx.xx
PROPERTY[REASON][0]=Premium Domain Name
PROPERTY[DOMAINCHECKTIME][0]=0.032
PROPERTY[CLASS][0]=PREMIUM_RIGHTSIDE_P
PROPERTY[CURRENCY][0]=USD
PROPERTY[DOMAINCHECK][0]=211 Premium Domain name available [PREMIUM]
DESCRIPTION=Command completed successfully
CODE=200
QUEUETIME=0.001
RUNTIME=0.208

The "CLASS" parameter have to be used at the AddDomain command:

command = AddDomainApplication
class = PREMIUM_RIGHTSIDE_P
...

In order to query the renewal price of a dedicated domain of your portfolio you can extend the StatusDomain command as follows. This is also possible for premium domains:
REQUIRED

[COMMAND]
command = StatusDomain
domain = <DOMAIN>
properties = PRICE
EOF

[RESPONSE]
...
PROPERTY[CURRENCY][0]=EUR
PROPERTY[RENEWALPRICE][0]=10.00
PROPERTY[RENEWALGROSSPRICE][0]=11.90
PROPERTY[VAT][0]=19.00
...
EOF

In order to explicitly renew a premium domain you have to query the premium class of the domain first. The premium class is returned as SUBCLASS from a StatusDomain command and it always starts with PREMIUM_ for premium domains. If the optional parameter properties=PRICE is also provided then the response also includes the fee for a renewal with the default renewal period:

REQUIRED

[COMMAND]
command = StatusDomain
domain = <PREMIUMDOMAIN>
EOF

[RESPONSE]
...
PROPERTY[SUBCLASS][0]=PREMIUM_REGISTRY_TIER
...
EOF

The SUBCLASS of the premium domain has to be provided as CLASS parameter in an explicit renewal request in order to renew a premium domain:
REQUIRED

[COMMAND]
command = RenewDomain
domain = <PREMIUMDOMAIN>
class = PREMIUM_REGISTRY_TIER
EOF

[RESPONSE]
...
CODE=200
DESCRIPTION=Command completed successfully
PROPERTY[DOMAIN][0]=<PREMIUMDOMAIN>
PROPERTY[EXPIRATIONDATE][0]=2020-02-20 12:00:00
...
EOF