知識庫

RegisterDomain:

This command is used to send a Register command to the registrar.

Request Parameters

Name	Type	Required?	Description
sld	String	Yes	Domain name
tld	String	Yes	Suffix attached to domain name
regperiod	Number	Yes	Registration period
nameserver1	String	No	First nameserver
nameserver2	String	No	Second nameserver
nameserver3	String	No	Third nameserver
nameserver4	String	No	Fourth nameserver
nameserver5	String	No	Fifth nameserver
dnsmanagement	Number	No	Enables dns management for this domain
emailforwarding	Number	No	Enables email forwarding for this domain
idprotection	Number	No	Enables id protection for this domain
firstname	String	Yes	First name of the user
lastname	String	Yes	Last name of the user
address1	String	Yes	First part of user address
address2	String	No	Second part of user address
city	String	Yes	City of the user
state	String	Yes	State/Province of the user
postcode	String	Yes	Postal/ZIP Code of the user
country	String	Yes	Country of the user
phonenumber	String	Yes	Phone number in the format +NNN.NNNNNNNNNN
email	String	Yes	Email address of the user
adminfirstname	String	No	First name of the admin user
adminlastname	String	No	Last name of the admin user
adminaddress1	String	No	First part of admin user address
adminaddress2	String	No	Second part of admin user address
admincity	String	No	City of the admin user
adminstate	String	No	State/Province of the admin user
adminpostcode	String	No	Postal/ZIP Code of the admin user
admincountry	String	No	Country of the admin user
adminphonenumber	String	No	Phone number in the format +NNN.NNNNNNNNNN
adminemail	String	No	Email address of the admin user
domainfields	String	No	A base64 encoded serialized array of the TLD specific field values

Example Request:

curl 'https://my.host.al/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&[email protected]&action=RegisterDomain&sld=exampledomain&tld=com&regperiod=1&nameserver1=ns1.yourdomain.com&nameserver2=ns2.yourdomain.com&firstname=test&lastname=test&companyname=company&address1=addresss&city=city&state=region&country=US&postcode=12345&phonenumber=1234567890&[email protected]' --compressed

Example Response:

{"result":"success","msg":"Domain has been registered"}

TransferDomain

This command is used to send a Transfer command to the registrar.

Request Parameters

Name	Type	Required?	Description
sld	String	Yes	Domain name
tld	String	Yes	Suffix attached to domain name
transfersecret	String	No	Domain authorization code
regperiod	Number	Yes	Registration period
nameserver1	String	No	First nameserver
nameserver2	String	No	Second nameserver
nameserver3	String	No	Third nameserver
nameserver4	String	No	Fourth nameserver
nameserver5	String	No	Fifth nameserver
dnsmanagement	Number	No	Enables dns management for this domain
emailforwarding	Number	No	Enables email forwarding for this domain
idprotection	Number	No	Enables id protection for this domain
firstname	String	Yes	First name of the user
lastname	String	Yes	Last name of the user
address1	String	Yes	First part of user address
address2	String	No	Second part of user address
city	String	Yes	City of the user
state	String	Yes	State/Province of the user
postcode	String	Yes	Postal/ZIP Code of the user
country	String	Yes	Country of the user
phonenumber	String	Yes	Phone number in the format +NNN.NNNNNNNNNN
email	String	Yes	Email address of the user
adminfirstname	String	No	First name of the admin user
adminlastname	String	No	Last name of the admin user
adminaddress1	String	No	First part of admin user address
adminaddress2	String	No	Second part of admin user address
admincity	String	No	City of the admin user
adminstate	String	No	State/Province of the admin user
adminpostcode	String	No	Postal/ZIP Code of the admin user
admincountry	String	No	Country of the admin user
adminphonenumber	String	No	Phone number in the format +NNN.NNNNNNNNNN
adminemail	String	No	Email address of the admin user
domainfields	String	No	A base64 encoded serialized array of the TLD specific field values

Example Request:

curl 'https://my.host.al/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&[email protected]&action=TransferDomain&sld=exampledomain&tld=com&transfersecret=gd23h231s21&regperiod=1&nameserver1=ns1.yourdomain.com&nameserver2=ns2.yourdomain.com&firstname=test&lastname=test&companyname=company&address1=addresss&city=city&state=region&country=US&postcode=12345&phonenumber=1234567890&[email protected]' --compressed

Example Response:

{"result":"success","msg":"Domain transfer initiated successfully."}

RenewDomain

This command is used to send a Renew command to the registrar.

Request Parameters

Name	Type	Required?	Description
sld	String	Yes	Domain name
tld	String	Yes	Suffix attached to domain name
regperiod	Number	Yes	Registration period

Example Request:

curl 'https://www.host.al/clientarea/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&[email protected]&action=RenewDomain&sld=exampledomain&tld=com&regperiod=1' --compressed

Example Response:

{"result":"success","msg":"The domain has been successfully."}

GetNameservers

This command is used to obtain the nameservers of a domain.

Request Parameters

Name	Type	Required?	Description
sld	String	Yes	Domain name
tld	String	Yes	Suffix attached to domain name

Example Request:

curl 'https://www.host.al/clientarea/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&[email protected]&action=GetNameservers&sld=exampledomain&tld=com' --compressed

Example Response:

{"result":"success","ns1":"ns1.exampledomain.com","ns2":"ns2.exampledomain.com"}

SaveNameservers

This command is used to update the nameservers of a domain.

Request Parameters

Name	Type	Required?	Description
sld	String	Yes	Domain name
tld	String	Yes	Suffix attached to domain name
nameserver1	String	No	First nameserver
nameserver2	String	No	Second nameserver
nameserver3	String	No	Third nameserver
nameserver4	String	No	Fourth nameserver
nameserver5	String	No	Fifth nameserver

Example Request:

curl 'https://www.host.al/clientarea/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&[email protected]&action=SaveNameservers&sld=exampledomain&tld=com&ns1=ns1.exampledomain.com&ns2=ns2.exampledomain.com' --compressed

Example Response:

{"result":"success"}

GetContactDetails

This command is used to perform a whois lookup on a specified domain.

Request Parameters

Name	Type	Required?	Description
sld	String	Yes	Domain name
tld	String	Yes	Suffix attached to domain name

Example Request:

curl 'https://www.host.al/clientarea/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&[email protected]&action=GetContactDetails&sld=exampledomain&tld=com' --compressed

Example Response:

{"result":"success","Registrant":{"Name":"John Doe","Company":"Company name","Address":"P.O.","City":"Amsterdam","Country":"NL","Zip_Code":"1001 GT","Email":"[email protected]","Telephone":"N\/A"}}

SaveContactDetails

his command is used to update the contact information on a domain.

Request Parameters

Name	Type	Required?	Description
sld	String	Yes	Domain name
tld	String	Yes	Suffix attached to domain name
contactdetails	Array	Yes

Example Request:

curl 'https://www.host.al/clientarea/domainsResellerAPI/api.php' --data 'token=AaLc8eNZWsZtWlT9LtT7NUha&[email protected]&action=SaveContactDetails&sld=exampledomain&tld=com&contactdetails[Registrant][Name]=John%20Doe&contactdetails[Registrant][Company]=Company%20name&contactdetails[Registrant][Address]=Address&contactdetails[Registrant][City]=Amsterdam&contactdetails[Registrant][Country]=NL&contactdetails[Registrant][Zip_Code]=1001 GT&contactdetails[Registrant][Email][email protected]&contactdetails[Registrant][Telephone]=N/A' --compressed

Example Response:

{"result":"success","Registrant":{"Name":"John Doe","Company":"Company name","Address":"P.O.","City":"Amsterdam","Country":"NL","Zip_Code":"1001 GT","Email":"[email protected]","Telephone":"N\/A"}}