Basic Name Server Monitor Example

This sample invokes and displays the results of a DomainTools "Name Server Monitor" via DXL.

For more information see:
https://www.domaintools.com/resources/api-documentation/name-server-monitor/

Prerequisites

Running

To run this sample execute the sample/basic/basic_name_server_monitor_example.py script as follows:

python sample/basic/basic_name_server_monitor_example.py

The output should appear similar to the following:

{
    "response": {
        "alerts": [
            {
                "action": "Transfer Out",
                "domain": "00000000000.PW",
                "new_name_server": "i-now.cn",
                "old_name_server": "dnspod.net"
            },
            {
                "action": "New",
                "domain": "1524QQ.COM",
                "new_name_server": "dnspod.net",
                "old_name_server": ""
            }
        ],
        "date": "2017-07-18",
        "limit": 1000,
        "name_server": "DNSPOD.NET",
        "page": 1,
        "page_count": 35,
        "total": "34494"
    }
}

The received results are displayed.

Details

The majority of the sample code is shown below:

# Create the client
with DxlClient(config) as dxl_client:

    # Connect to the fabric
    dxl_client.connect()

    logger.info("Connected to DXL fabric.")

    # Create client wrapper
    client = DomainToolsApiClient(dxl_client)

    # Invoke 'name_server_monitor' method on service
    resp_dict = client.name_server_monitor("DNSPOD.NET")

    # Print out the response (convert dictionary to JSON for pretty printing)
    print("Response:\n{}".format(
        MessageUtils.dict_to_json(resp_dict, pretty_print=True)))

Once a connection is established to the DXL fabric, a dxldomaintoolsclient.client.DomainToolsApiClient instance is created which will be used to invoke remote commands on the DomainTools API DXL service.

Next, the dxldomaintoolsclient.client.DomainToolsApiClient.name_server_monitor() method is invoked with a hostname.

The final step is to display the contents of the returned dictionary (dict) which contains the results of the name server monitor query.

From the DomainTools Name Server Monitor documentation:

"The Name Server Monitor API searches the daily activity of all our monitored TLDs on any given name server. New, Deleted and Transferred domains records can be queried up to 6 days in the past."