Black Friday promo up to -50% Time left:

Hourly statistics

Description

Gets hourly 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
month Integer Required From which the statistics are
day 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"}

When one of the year, month and day parameters 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/month/day."}

Note: These are example errors in JSON format.


Example

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


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


Last modified: 2020-01-13
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more