Simple DNS Plus v. 4.00
How to use HTTP commands

Simple DNS Plus can be prompted to perform different actions through HTTP - either directly from a browser, or any other program that can communicate through HTTP.

This functionality is not intended as a direct user interface, but rather a way to communicate with Simple DNS Plus from other applications over the network (for example ASP script pages running on IIS).

By default, Simple DNS Plus listens for HTTP requests on IP address 127.0.0.1 port 8053.
With this default configuration, you can open a web-page listing the available commands in your browser using http://127.0.0.1:8053

Port 8053 is used to avoid conflicts with any web server software using the standard port 80 on the same machine.
Please note that only the same computer can connect to IP 127.0.0.1, so if you need to access this from another computer, you will need to configure Simple DNS Plus to listen on a different IP address.
You can change these setting in the Options dialog / HTTP API section.

Simple DNS Plus accepts both HTTP "GET" and "POST" requests - use whichever is more convenient.
When using "GET", all fields and values must be part of the URL.
When using "POST", all fields and values must be in the message (none in the URL).

The response will either be a text document ("text/plain" mime type) containing the result, an error 404 for unrecognized commands, or error 406 for requests that could no be performed.

The request document/path name must be one of the commands described below.
For example to list the contents of the zone file for simpledns.com, you could use the following (with GET):
http://127.0.0.1:8053/getzone?zone=simpledns.com

Commands:

·status  
Returns server status and request counters in text format.  
 
·clearcache  
Clears the DNS cache.  

·reloadall  
Reloads all zone data from disk.  
 
·zonelist  
Returns a list of all zone names on the server (separated by <CRLF>).  
Optionally include the field "listtype", being either "simple" (the default), "primary" (primary zones only), "secondary" (secondary zones only), or "extended".  
Optionally specify a numeric ID in the field "zonegroup" matching a group ID in the "editrecs.ini" file to limit the list to a single zone group.  
 
·getzone  
Returns the text of a zone file.  
Specify the zone name in the field "zone".  
 
·loadzone  
Reloads an existing zone from disk.  
Specify the zone name in the field "zone".  
 
·removezone  
Removes an existing zone from the server.  
Specify the zone name in the field "zone".  

·updatehost  
Updates, creates, or deletes an A-record (host address).  
A parent zone must already exist for the host name.  
Specify the host name in the field "host".  
Specify an IP address in the field "data".  
If no data (IP address) is specified, the record is deleted.  

·updatezone  
Updates or creates a new zone on the server.  
Specify the zone name in the field "zone".  
Specify the zone data in the field "data" (formatted as a standard zone file).  
For secondary zones, specify the primary server IP address in the field "masterip".  
Optionally specify a numeric ID in the field "zonegroup" matching a group ID in the "editrecs.ini" file.  
Make sure to increment the SOA-record serial number when using this command.  



© 1999-2005 JH Software - All rights reserved