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

Monthly statistics

Description

Gets daily statistics for the requested zone

Note: This function is available for master, slave and cloud/bulk zones. Works with reverse zones too.


 Parameters

Name Data Type Status Description
auth-id Integer Required Authentication parameter
auth-password String Required Authentication parameter
domain-name String Required Domain name or reverse zone name whose statistics you want to see
year Integer Required From which the statistics are

Response: Array with dates and requests or failed status with 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."}

When invalid or non-existant domain-name is entered, the following status will be returned:

{"status":"Failed","statusDescription":"Missing domain-name"}

If the year parameter is not valid or Integer, the API request will fail and the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":""[entered value] is not a valid year."}

Note: These are example errors in JSON format.


Example

URL JSON: https://api.cloudns.net/dns/statistics-monthly.json
Domain POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&year=2012
Reverse IPv4 POST/GET: auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&year=2012
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&year=2012

URL XML: https://api.cloudns.net/dns/statistics-monthly.xml
Domain POST/GET: auth-id=0&auth-password=password&domain-name=domain.com&year=2012
Reverse IPv4 POST/GET: auth-id=0&auth-password=password&domain-name=1.0.0.127.in-addr.arpa&year=2012
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&year=2012


Last modified: 2019-07-04
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more