Case Study - Global Reach, Local Touch: The Role of GeoDNS in eCommerce Expansion

Register Domain Zone

Description

Register a new domain zone. Works with reverse dns zones too.


Parameters

Name Data Type Status Description
auth-id or sub-auth-id or sub-auth-user Integer Required Authentication parameter
auth-password String Required Authentication parameter
domain-name String Required Domain name or reverse zone name that you want to Register
zone-type String Required Zone type - master/slave/parked/geodns
ns Array Optional Array with name servers, which will be used for starting NS records. If parameter ns is added, default NS records will be not added. For master zones only.
master-ip String Optional Master server IP address. For slave zones only. It can be IPv4 or IPv6

Return: Array with status and status description.


Errors

When the authenctication of API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

In case the credentials of API sub user are invalid, the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect sub-auth-id, sub-auth-user or auth-password."}

If the DNS zone already exists in the ClouDNS system:

{"status":"Failed","statusDescription":"domain.tld has been already added."}

When an invalid domain name is entered:

{"status":"Failed","statusDescription":"xxxx is invalid domain name."}

When the zone type is not valid or available for your account, e.g. GeoDNS zone for non-GeoDNS account:

{"status":"int(0)","statusDescription":"Your plan does not support GeoDNS zones."}

If an invalid master-ip for Slave zone is entered:

{"status":"Failed","statusDescription":"Invalid IP address for the master server."}

Note: These are example errors in JSON format, if there are missing or wrong parameters, an error will be displayed again.


Example for master zone

URL JSON: https://api.cloudns.net/dns/register.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=master
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=master

URL XML: https://api.cloudns.net/dns/register.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=master
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=master

URL JSON: https://api.cloudns.net/dns/register.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=master&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=master&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net

Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&zone-type=master
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&zone-type=master

Reverse IPv6 POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&zone-type=master
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&zone-type=master

URL XML: https://api.cloudns.net/dns/register.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=master&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=master&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net

Reverse IPv4 POST/GET:
auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&zone-type=master
sub-auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&zone-type=master

Reverse IPv6 POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&zone-type=master
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.3.4.5.6.7.8.9.0.1.2.ip6.arpa&zone-type=master

URL JSON: https://api.cloudns.net/dns/register.json
ENUM POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.e164.arpa&zone-type=master&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.e164.arpa&zone-type=master&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net

ENUM POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.e164.arpa&zone-type=master
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.e164.arpa&zone-type=master

URL XML: https://api.cloudns.net/dns/register.xml
ENUM POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.e164.arpa&zone-type=master&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.e164.arpa&zone-type=master&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net

ENUM POST/GET:
auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.e164.arpa&zone-type=master
sub-auth-id=0&auth-password=password&domain-name=1.2.3.4.5.6.7.8.9.e164.arpa&zone-type=master

Example for Parked zone

URL JSON: https://api.cloudns.net/dns/register.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=parked
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=parked

URL XML: https://api.cloudns.net/dns/register.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=parked
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=parked

URL JSON: https://api.cloudns.net/dns/register.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=parked&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=parked&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net

URL XML: https://api.cloudns.net/dns/register.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=parked
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=parked&ns[]=pns1.cloudns.net&ns[]=pns2.cloudns.net

Example for GeoDNS zone

URL JSON: https://api.cloudns.net/dns/register.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=geodns
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=geodns

URL XML: https://api.cloudns.net/dns/register.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=geodns
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=geodns

URL JSON: https://api.cloudns.net/dns/register.json
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=geodns&ns[]=gns1.cloudns.net&ns[]=gns2.cloudns.net
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=geodns&ns[]=gns1.cloudns.net&ns[]=gns2.cloudns.net

URL XML: https://api.cloudns.net/dns/register.xml
Domain POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&zone-type=geodns&ns[]=gns1.cloudns.net&ns[]=gns2.cloudns.net
sub-auth-id=0&auth-password=password&domain-name=domain.com&zone-type=geodns&ns[]=gns1.cloudns.net&ns[]=gns2.cloudns.net


Last modified: 2022-06-24
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more