Register a new domain zone. Works with reverse dns zones too.
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 |
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.
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
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
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