The main purpose for this data call is to power the DNS Check widget [1] but it can also be used to programmatically retrieve the test results of DNS checks run by Zonemaster.
The data call has two modes, one to get an overview of available tests ("resource" parameter is hostname) and one to get the test details ("resource" parameter is test ID and "method" parameter is "details").
[1] https://stat.ripe.net/widget/zonemaster
Please note that this data call is in development and features/availability can change.
https://stat.ripe.net/data/zonemaster/data.<format>?<parameters>
e.g. https://stat.ripe.net/data/zonemaster/data.json?resource=0.0.193.in-addr.arpa
Key | Value | Info | Required |
---|---|---|---|
resource |
hostname or ID of a DNS test |
The hostname the DNS checks are based on or the ID of the test result | Yes |
method | "details" | This is necessary when retrieving test details and when the "resource" parameter is a test ID | No - not when "resource" parameter is a hostname |
https://stat.ripe.net/data/zonemaster/data.json?resource=stat.ripe.net
"data": { "result": [ { "advanced_options": null, "creation_time": "2017-12-07 10:58:52", "id": "8b9b9a1ab9200ed9", "overall_result": "critical" }, { "advanced_options": null, "creation_time": "2017-07-31 08:59:01", "id": "408470530366d5bf", "overall_result": "critical" } ], "parameters": { "resource": "stat.ripe.net", "method": "overview" } }
https://stat.ripe.net/data/zonemaster/data.json?resource=8b9b9a1ab9200ed9&method=details
"data": { "result": { "creation_time": "2017-12-07 10:58:52", "results": [ { "message": "Using version v1.1.0 of the Zonemaster engine.\n", "module": "SYSTEM", "level": "INFO" }, { "message": "Configuration was read from DEFAULT CONFIGURATION\n", "module": "SYSTEM", "level": "INFO" }, { "message": "Policy was read from DEFAULT POLICY\n", "module": "SYSTEM", "level": "INFO" }, { "message": "Nameserver for zone ripe.net replies when trying to fetch glue.\n", "module": "BASIC", "level": "INFO" }, { "message": "Nameservers for \"ripe.net\" provided no NS records for tested zone. RCODE given was NOERROR.\n", "module": "BASIC", "level": "CRITICAL" }, { "message": "stat.ripe.net is not a zone.\n", "module": "BASIC", "level": "CRITICAL" }, { "message": "No NS records for tested zone from parent. NS tests aborted.\n", "module": "BASIC", "level": "INFO" }, { "message": "Not enough data about stat.ripe.net was found to be able to run tests.\n", "module": "SYSTEM", "level": "CRITICAL" } ], "params": { "user_ip": "127.0.0.1", "domain": "stat.ripe.net", "client_version": "1.0.7", "client_id": "Zonemaster Dancer Frontend" }, "id": 801081, "hash_id": "8b9b9a1ab9200ed9" }, "parameters": { "resource": "8b9b9a1ab9200ed9", "method": "details" } }