Gets the number of pages with zones. The method can be combined with search option. If you use optional search parameter, you will get the number of pages with zones that match the search. Works with reverse 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 |
rows-per-page | Integer | Required | Results per page. Can be 10, 20, 30, 50 or 100 |
search | String | Optional | Domain name, reverse zone name or keyword to search in the zone names for |
group-id | Integer | Optional | ID of the relevant group. If group's ID is set up, the pages for all zones in this group will be counted. If value none is set up for parameter group-id, the pages for all not included zones in this group will be counted. |
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."}
When rows-per-page paremeter is not from the suggested values (10, 20, 30, 50 or 100) or Integer, the API request will fail and the following status and statusDescription will be returned:
{"status":"Failed","statusDescription":"Wrong or missing required parameter 'rows-per-page'."}
Note: These are example errors in JSON format.
URL JSON: https://api.cloudns.net/dns/get-pages-count.json
POST/GET: auth-id=0&auth-password=password&rows-per-page=10
POST/GET: sub-auth-id=0&auth-password=password&rows-per-page=10
URL XML: https://api.cloudns.net/dns/get-pages-count.xml
POST/GET: auth-id=0&auth-password=password&rows-per-page=10
POST/GET: sub-auth-id=0&auth-password=password&rows-per-page=10