Adds a new api sub user
Name | Data Type | Status | Description |
auth-id | Integer | Required | Authentication parameter |
auth-password | String | Required | Authentication parameter |
password | String | Required | Password of the new sub user |
sub-auth-user | String | Optional | Username for the new sub user |
zones | Integer | Required | Amount of allowed DNS zones |
mail forwards | Integer | Required | Amount of allowed mail forwards |
ip | Integer | Optional | Whitelisted IP address. If no IP address is provided the access from all IPs will be allowed. |
records | Integer | Optional | Amount of allowed records. |
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 zone limit or the zone field value is not numeric, the following status will be returned:
{"status":0,"message":"The zones field values must be numeric"}
If there is not added a mail forward limit or the mail forward field value is not numeric, the following status will be returned:
{{"status":0,"message":"The mail forward field value must be numeric"}
When the added IP address is not valid, the following status will be returned:
{"status":0,"message":"Invalid IP address."}
Note: These are example errors in JSON format
URL JSON: https://api.cloudns.net/sub-users/add.json
POST/GET: auth-id=0&auth-password=password&sub-auth-user=user&password=password&zones=12&mail-forwards=13&ip=1.2.3.5&records=200
URL XML: https://api.cloudns.net/sub-users/add.xml
POST/GET: auth-id=0&auth-password=password&sub-auth-user=user&password=password&zones=12&mail-forwards=13&ip=1.2.3.5&records=200