Zonemaster

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

Parameters

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

Output

Get overview of available tests

https://stat.ripe.net/data/zonemaster/data.json?resource=stat.ripe.net

Example
      "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"
          }
        }
    

Get test details

https://stat.ripe.net/data/zonemaster/data.json?resource=8b9b9a1ab9200ed9&method=details

Example
      "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"
          }
        }
    

deprecated - n.a.

upcoming - n.a.