Technitium Stats Integration

NickKatchur · May 4, 2024, 3:17pm

I unfortunately don’t have the programming knowledge to do this. But am throwing this out there to hopefully someone who does!

Technitium DNS Server has a well documented API that returns configurable statistics that would allow for the integration of DNS statistics similar to that which Pi-Hole does. All that I think would be needed to set up would be server IP and a username/password to create an API key. Afterwards it would just be simply polling for JSON results using the key. Think this would be a great addition for those of us who use Technitium.

github.com

TechnitiumSoftware/DnsServer/blob/175a7c5328451c2d1ba3aa7e007a6bd110b79f45/APIDOCS.md

# Technitium DNS Server API Documentation

Technitium DNS Server provides a HTTP API which is used by the web console to perform all actions. Thus any action that the web console does can be performed using this API from your own applications.

The URL in the documentation uses `localhost` and port `5380`. You should use the hostname/IP address and port that is specific to your DNS server instance.

## API Request

Unless it is explicitly specified, all HTTP API requests can use both `GET` or `POST` methods. When using `POST` method to pass the API parameters as form data, the `Content-Type` header must be set to `application/x-www-form-urlencoded`. When the HTTP API call is used to upload files, the call must use `POST` method and the `Content-Type` header must be set to `multipart/form-data`.

## API Response Format

The HTTP API returns a JSON formatted response for all requests. The JSON object returned contains `status` property which indicate if the request was successful. 

The `status` property can have following values:
- `ok`: This indicates that the call was successful.
- `error`: This response tells the call failed and provides additional properties that provide details about the error.
- `invalid-token`: When a session has expired or an invalid token was provided this response is received.

A successful response will look as shown below. Note that there will be other properties in the response which are specific to the request that was made.

This file has been truncated. show original

Amateur-God · June 21, 2024, 2:43am

@NickKatchur here you go

has a total of arround 21 entities/sensors for different information that i thought would be relevant or nice to know including if there is an update available