Modifies the name servers of the domain
Notes:
Name | Data Type | Status | Description |
auth-id | Integer | Required | Authentication parameter |
auth-password | String | Required | Authentication parameter |
domain-name | String | Required | Name of the domain |
nameservers | Array | Required | Array with the name servers |
When the authentication 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."}
If there is not added a domain name or if the requested domain does not exist in your account, the following status will be returned:
{"status":"Failed","statusDescription":"Missing domain-name"}
For most of the domains the minimum set for name servers is 2. If you add only 1 name server, the following status will be returned:
{"status":"Failed","statusDescription":"The minimum name servers for .com domains are 2."}
Note: These are example errors in JSON format.
URL JSON: https://api.cloudns.net/domains/set-nameservers.json
POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&nameservers[]=ns1.domain.com&nameservers[]=ns2.domain.com
URL XML: https://api.cloudns.net/domains/set-nameservers.xml
POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&nameservers[]=ns1.domain.com&nameservers[]=ns2.domain.com
URL JSON: https://api.cloudns.net/domains/set-nameservers.json
POST/GET: auth-id=0&auth-password=password&domain-name=domain.be&nameservers[]=ns1.domain.be 127.0.0.1&nameservers[]=ns2.domain.be 127.0.0.2
URL XML: https://api.cloudns.net/domains/set-nameservers.xml
POST/GET: auth-id=0&auth-password=password&domain-name=domain.be&nameservers[]=ns1.domain.be 127.0.0.1&nameservers[]=ns2.domain.be 127.0.0.2