Gestione Zone DNS

setdnsdefault

Description

Set domain name ns to default (use domainregister nameserver)

Input Parameters

Name Allowed Values
userid Your Domain Register Reseller ID
privatekey Your Reseller Private Key
command setdnsdefault
domain Domain name
setdnsdefault TRUE or FALSE

Output Parameters

Name Allowed Values
command setdnsdefault
domain Domain name
errcode Successful if 0
errdesc

Description of error returned or command completed successfully if no errors detected

Example URL

api.domainregister.it/interface.php?command=setdnsdefault&domain=abc123.com&userid=resellerID&privatekey=myprivatekey&setdnsdefault=TRUE

 

listrecordzone

Description

Get the list of all record for this zone.

Input Parameters

Name Allowed Values
userid Your Domain Register Reseller ID
privatekey Your Reseller Private Key
command

listrecordzone

domain Domain name
filter type record (A,AAAA,CNAME,MX,TXT,SRV) *optional

Output Parameters

Name Allowed Values
command listrecordzone
domain Domain name
recordzone record
errcode Successful if 0
errdesc

Description of error returned or command completed successfully if no errors detected

Example URL

api.domainregister.it/interface.php?command=listrecordzone&domain=abc123.com&userid=resellerID&privatekey=myprivatekey

 

addrecordzone

Description

Add a new record to this zone.

Input Parameters

Name Allowed Values
userid Your Domain Register Reseller ID
privatekey Your Reseller Private Key
command

addrecordzone

domain Domain name
type type record (A,AAAA,CNAME,MX,SRV,TXT)
content name of record (ex. for www.domain.com the value is www)
value value of record (ex. for A record the value is IP Address)
ttl value of time to live
prio valid only for MX record, priority of mail server.

Output Parameters

Name Allowed Values
command addrecordzone
domain Domain name
errcode Successful if 0
errdesc

Description of error returned or command completed successfully if no errors detected

Example URL

api.domainregister.it/interface.php?command=addrecordzone&domain=abc123.com&userid=resellerID&privatekey=myprivatekey&type=A&content=www2&value=1.1.1.1&ttl=60
api.domainregister.it/interface.php?command=addrecordzone&domain=abc123.com&userid=resellerID&privatekey=myprivatekey&type=CNAME&content=www2&value=dev.abc123.com&ttl=60
api.domainregister.it/interface.php?command=addrecordzone&domain=abc123.com&userid=resellerID&privatekey=myprivatekey&type=MX&content=&value=mail.abc123.com&ttl=60&prio=10

 

delrecordzone

Description

Delete a record from the zone.

Input Parameters

Name Allowed Values
userid Your Domain Register Reseller ID
privatekey Your Reseller Private Key
command

delrecordzone

recordid ID get from listrecordzone

Output Parameters

Name Allowed Values
command delrecordzone
recordID Id record delete
errcode Successful if 0
errdesc

Description of error returned or command completed successfully if no errors detected

Example URL

api.domainregister.it/interface.php?command=delrecordzone&userid=resellerID&privatekey=myprivatekey&recordid=1111

Overview

The DomainRegister.it reseller program is a great way to automate domain name registrations on your website.

With limited coding knowledge you can develop and integrate our API into your applications.

Since the API uses XML to communicate and return results, a variety of programming languages and scripts can be utilized.

How it works
  • You prefund your DomainRegister.it account with sufficient funds to cover the cost of registrations , transfers and domain name renewals
  • You can only process purchases if you have sufficient funds in your account, otherwise you will receive an insufficient funds error
  • You can add up to four IP Addresses of your systems that are allowed to communicate to the reseller API interface
  • Any names registered, transferred via the API can also be managed via the DomainRegister.it control panel making it easy to manage your account names
What is not permitted
    Any abuse of our API such as excessive check or register commands will not be tolerated
    If we detect excessive usage relative to successful purchases your reseller privileges may be revoked
What is being developed
    As each module is available they will be released into the API
 How can I obtain support

Please go to the DomainRegister.it control panel and raise a support ticket.


renew function

 

renew

Description

Renew a domain name

Input Parameters

Name Allowed Values
userid Your Domain Register Reseller ID
privatekey Your Reseller Private Key
command renew
domain Domain name to renew
years Number of years to renew domain name by. Minimum is 1 year, Maximum in most cases is 10 years

Output Parameters

Name Allowed Values
command renew
domain Domain name to be renewed
errcode Successful if 0
errdesc

Description of error returned or command completed successfully if no errors detected

Example URL

api.domainregister.it/interface.php?command=renew&domain=abc123.com&years=1&userid=resellerID&privatekey=myprivatekey

Financial Functions

get_balance

Description

Function retrieves the current balance from the resellers account.

Input Parameters

Name Allowed Values
userid Your Domain Register Reseller ID
privatekey Your Reseller Private Key
command get_balance

Output Parameters

Name Allowed Values
balance Current Reseller balance
errcode Successful if 0
errdesc Description of error returned or command completed successfully if no errors detected

Example URL

api.domainregister.it/interface.php?command=get_balance&userid=resellerID&privatekey=myprivatekey

Check/Register Functions

check

Description

Check to see if a domain name is available for registration

Input Parameters

Name Allowed Values
userid Your Domain Register Reseller ID
privatekey Your Reseller Private Key
command check
domains Domain name to check. You can specify a list of domain names seperated by the | (pipe) character

Output Parameters

Name Allowed Values
command(n) check
domain(n) Domain name results based on
errcode(n) 210 = Name Available, 211= Name is taken, all else denotes error
errdesc(n)

See errcode above

Example URL

api.domainregister.it/interface.php?command=check&domains=abc123.com|abc21234.com|absbsbsbs.info&userid=resellerID&privatekey=myprivatekey

register

 

Description

Register a domain name. All fields are required. The phone/fax number must be properly formatted

Input Parameters

Name Allowed Values
userid Your Domain Register Reseller ID
privatekey Your Reseller Private Key
command register
domain Domain name
years Number of years to register. Minimum is 1 year, maximum is 10 years
idRegistrant id Profile for Registrant
idAdmin id Profile for Admin
idBilling id Profile for billing
idTech id Profile for technical contact
dns1 Domain Name Server 1 (e.g. ns1.drnameservice.com)
dns2 Domain Name Server 2 (e.g. ns2.drnameservice.com)

Output Parameters

Name Allowed Values
command register
domain Domain name
errcode Successful if 0
errdesc

Description of error returned or command completed successfully if no errors detected

Example URL

api.domainregister.interface.php?command=register&userid=resellerID&privatekey=myprivatekey&SEE_ABOVE_PARAMETERS

 

transfer functions

transfer

Description

Transfer a domain name

Input Parameters

Name Allowed Values
userid Your Domain Register Reseller ID
privatekey Your Reseller Private Key
command transfer
domain Domain name to transfer
idRegistrant id Profile for Registrant
idAdmin id Profile for Admin (optional)
idBilling id Profile for Billing (optional)
idTech id Profile for Tech (optional)
eppKey EPP Key for transfer authorized
dns1 name server name (e.g. ns1.drnameservice.com)
dns2 name server name (e.g. ns2.drnameservice.com)

Output Parameters

Name Allowed Values
command transfer
domain Domain name transfer
errcode Successful if 0
errdesc

Description of error returned or command completed successfully if no errors detected

Example URL

api.domainregister.it/interface.php?command=transfer&userid=resellerID&privatekey=myprivatekey&SEE_ABOVE_PARAMETERS

 

gettransferstatus

Description

Obtain transfer status on a domain name

Input Parameters

Name Allowed Values
userid Your Domain Register Reseller ID
privatekey Your Reseller Private Key
command

gettransferstatus

domain Domain name to access status

Output Parameters

Name Allowed Values
command gettransferstatus
domain Domain name
timestamp Date transfer request submitted
reason Reason/Status code of transfer. Valid codes are (completed, pending_registry, pending_admin, pending_owner)
errcode Successful if 0
errdesc

Description of error returned or command completed successfully if no errors detected

Example URL

api.domainregister.it/interface.php?command=gettransferstatus&domain=abc123.com&userid=resellerID&privatekey=myprivatekey